Complete API Surface

CrawlKit exposes the full production platform in one API: 383 operations, 315 paths, 54 capability domains, and 532 typed schemas. This page is generated from /openapi.json so humans and agents can see the whole system without hunting.

No hidden platform surface. The API reference now includes Arrow/DataFusion query, ETL, workflow templates, pipeline internals, spider AI builder, crawl frontier, artifacts, lineage, quality, schema registry, OpenRate, telemetry, governance, healing, incidents, synthetic data, social, SEO, and every mounted production domain.

Most advanced surfaces first

🧪

Arrow + DataFusion data engineering

Register Parquet, query Arrow-native tables, export results, and move datasets through ETL stages.

🚀

Durable workflows

Reusable workflow templates, operation discovery, runs, cancellation, pipeline schedules, worker progress, and lineage.

🕷

Spider management

AI spider builder, selector suggestions, repair, factory batches, test runs, health, crawl jobs, frontiers, and proxy strategy.

📚

Scalar reference

Interactive request/response docs for all 383 operations and 532 schemas.

All API domains

DomainRepresentative operations
Alerts
5 operations
GET /api/v1/alerts

PUT /api/v1/alerts/:id/dismiss

GET /api/v1/alerts/insights

GET /api/v1/alerts/settings

PUT /api/v1/alerts/settings
Clients
10 operations
GET /api/v1/clients

POST /api/v1/clients

DELETE /api/v1/clients/:client_id

GET /api/v1/clients/:client_id

GET /api/v1/domains

POST /api/v1/domains

DELETE /api/v1/domains/:domain_id

GET /api/v1/domains/:domain_id/status
Health
2 operations
GET /api/v1/health/services
Service registry health
GET /health
Health check
Auth
6 operations
POST /api/v1/auth/tenants/provision
Provision tenant
GET /api/v1/auth/tokens
List tenant API tokens
POST /api/v1/auth/tokens
Create tenant API token
DELETE /api/v1/auth/tokens/{token_id}
Delete tenant API token
GET /api/v1/auth/usage
Get usage summary
POST /api/v1/auth/validate
Validate API key
GSC
12 operations
POST /api/v1/gsc/analytics
Search analytics
POST /api/v1/gsc/auth/callback
OAuth callback
POST /api/v1/gsc/auth/url
Get OAuth URL
POST /api/v1/gsc/index
Submit URL for indexing
POST /api/v1/gsc/index/remove
Request URL removal
POST /api/v1/gsc/inspect
Inspect URL
POST /api/v1/gsc/inspect/analyze
Inspect and analyze URL
POST /api/v1/gsc/inspect/batch
Batch inspect URLs
Analysis
8 operations
POST /api/v1/analysis/quality-pipeline
Trigger quality pipeline workflow
POST /api/v1/audit/run
Run authenticated audit with persistence
GET /api/v1/audits

GET /api/v1/audits/:audit_id

POST /api/v1/check

POST /api/v1/check-url

POST /api/v1/report

GET /api/v1/status
DNS
4 operations
POST /api/v1/dns/audit

POST /api/v1/dns/email-auth
Check email authentication
POST /api/v1/dns/redirects
Trace redirect chain
POST /api/v1/dns/ssl
Validate SSL/TLS certificate
Profile
3 operations
GET /api/v1/profile

PUT /api/v1/profile

POST /api/v1/profile/generate
Keywords
6 operations
GET /api/v1/keywords

PUT /api/v1/keywords

POST /api/v1/keywords/enrich
Enrich keywords with volume/difficulty
POST /api/v1/keywords/import/csv

POST /api/v1/keywords/import/gsc

POST /api/v1/keywords/recommend
Landscape
2 operations
GET /api/v1/landscape

PUT /api/v1/landscape/competitors
Content
9 operations
POST /api/v1/brief

GET /api/v1/briefs

DELETE /api/v1/briefs/:brief_id

GET /api/v1/briefs/:brief_id

PUT /api/v1/briefs/:brief_id

GET /api/v1/competitors

POST /api/v1/content/extract
Extract article content from a URL
POST /api/v1/links
Feedback
3 operations
POST /api/v1/feedback/record
Record feedback event
GET /api/v1/feedback/stats
Get feedback stats
GET /api/v1/feedback/status
Get pending verifications
IndexNow
3 operations
POST /api/v1/indexnow/key/generate
Generate IndexNow key
GET /api/v1/indexnow/key/verify
Verify IndexNow key
POST /api/v1/indexnow/submit
Submit URLs via IndexNow
Sites
5 operations
GET /api/v1/sites

POST /api/v1/sites

PUT /api/v1/sites

DELETE /api/v1/sites/:site_id

GET /api/v1/sites/:site_id
Dashboard
1 operations
GET /api/v1/dashboard
Audit
1 operations
POST /api/v1/audit
Real-time site audit (SSE)
Datasets
12 operations
GET /api/v1/datasets
List datasets
POST /api/v1/datasets
Create dataset
DELETE /api/v1/datasets/:dataset_id
Delete dataset
GET /api/v1/datasets/:dataset_id
Get dataset
PUT /api/v1/datasets/:dataset_id
Update dataset
POST /api/v1/datasets/:dataset_id/export
Export dataset
POST /api/v1/datasets/:dataset_id/import
Import data
GET /api/v1/datasets/:dataset_id/rows
List rows
Spiders
13 operations
GET /api/v1/spiders
List spiders
POST /api/v1/spiders
Create spider
DELETE /api/v1/spiders/:spider_id
Archive spider
GET /api/v1/spiders/:spider_id
Get spider
PUT /api/v1/spiders/:spider_id
Update spider
POST /api/v1/spiders/:spider_id/export
Export spider
GET /api/v1/spiders/:spider_id/health
Spider health
POST /api/v1/spiders/:spider_id/repair
Repair spider selectors
Enrichment
3 operations
POST /api/v1/enrichment/enrich
Enrich rows
GET /api/v1/enrichment/jobs/:job_id
Job status
GET /api/v1/enrichment/sources
List sources
Inspection
3 operations
POST /api/v1/inspection/html
Analyze HTML
POST /api/v1/inspection/selectors
Find selectors
POST /api/v1/inspection/url
Inspect URL
Pipelines
17 operations
GET /api/v1/pipelines
List pipelines
POST /api/v1/pipelines
Create pipeline
DELETE /api/v1/pipelines/:pipeline_id
Delete pipeline
GET /api/v1/pipelines/:pipeline_id
Get pipeline
PUT /api/v1/pipelines/:pipeline_id
Update pipeline
POST /api/v1/pipelines/:pipeline_id/run
Run pipeline
GET /api/v1/pipelines/:pipeline_id/runs
List runs
GET /api/v1/pipelines/:pipeline_id/schedule
Schedule status
Queue
6 operations
POST /api/v1/queue/dequeue
Dequeue items
POST /api/v1/queue/enqueue
Enqueue item
GET /api/v1/queue/items
List queue items
POST /api/v1/queue/purge
Purge queue
POST /api/v1/queue/retry
Retry queue item
GET /api/v1/queue/stats
Queue stats
Crawl
11 operations
GET /api/v1/crawl/frontier/:job_id
Get frontier stats
GET /api/v1/crawl/jobs
List crawl jobs
POST /api/v1/crawl/jobs
Create crawl job
GET /api/v1/crawl/jobs/:job_id
Get crawl job
POST /api/v1/crawl/jobs/:job_id/cancel
Cancel crawl job
POST /api/v1/crawl/jobs/:job_id/pause
Pause crawl job
POST /api/v1/crawl/jobs/:job_id/resume
Resume crawl job
GET /api/v1/crawl/proxies
List proxies
Content Workspace
12 operations
POST /api/v1/content/ai/generate
AI content generation
POST /api/v1/content/ai/rewrite
AI content rewrite
GET /api/v1/content/calendar
Get publishing calendar
GET /api/v1/content/documents
List content documents
POST /api/v1/content/documents
Create content document
GET /api/v1/content/documents/:id/approval-status
Get document approval status
POST /api/v1/content/documents/:id/approve
Approve document
POST /api/v1/content/documents/:id/reject
Reject document approval
Intelligence
10 operations
POST /api/v1/intelligence/causal
Estimate causal effect of SEO intervention
POST /api/v1/intelligence/enrich
Enrich domain with firmographics
POST /api/v1/intelligence/forecast
Revenue forecast with SEO assumptions
GET /api/v1/intelligence/graph
Query knowledge graph
POST /api/v1/intelligence/graph/impact
Analyze downstream impact of a node
POST /api/v1/intelligence/graph/propagate
Simulate signal propagation through graph
POST /api/v1/intelligence/graph/root-cause
Trace root causes of an anomaly
GET /api/v1/intelligence/insights
AI-generated strategic insights
Leads
11 operations
GET /api/v1/campaigns
List campaigns
POST /api/v1/campaigns
Create a campaign
GET /api/v1/campaigns/:id
Get a campaign
POST /api/v1/campaigns/:id/advance
Advance leads in a campaign
GET /api/v1/leads
List leads
POST /api/v1/leads
Create a lead
DELETE /api/v1/leads/:id
Delete a lead
GET /api/v1/leads/:id
Get a lead
Pipeline
6 operations
GET /api/v1/pipeline
Get pipeline overview
GET /api/v1/pipeline/attribution
Get SEO attribution data
GET /api/v1/pipeline/deals
List deals
POST /api/v1/pipeline/deals
Create a deal
PUT /api/v1/pipeline/deals/:id
Update a deal
GET /api/v1/pipeline/forecast
Get pipeline forecast
Scoring
9 operations
POST /api/v1/scoring/batch

POST /api/v1/scoring/compare

POST /api/v1/scoring/compute

POST /api/v1/scoring/explain

GET /api/v1/scoring/history

GET /api/v1/scoring/models

PUT /api/v1/scoring/models/{model_type}

GET /api/v1/scoring/results
Measurement
9 operations
GET /api/v1/measurement/attributions

POST /api/v1/measurement/calibrate

GET /api/v1/measurement/calibration-history

GET /api/v1/measurement/dashboard

GET /api/v1/measurement/experiments

POST /api/v1/measurement/experiments

GET /api/v1/measurement/experiments/{id}

POST /api/v1/measurement/experiments/{id}/cancel
Social - Reddit
16 operations
GET /api/v1/social/reddit/authors/:author/comments
Fetch recent comments authored by a Reddit user
GET /api/v1/social/reddit/authors/:author/posts
Fetch recent posts authored by a Reddit user
POST /api/v1/social/reddit/discover
Discover relevant Reddit communities by keywords
GET /api/v1/social/reddit/mentions
List Reddit mentions
GET /api/v1/social/reddit/mentions/:mention_id
Get a Reddit mention
GET /api/v1/social/reddit/monitors
List Reddit monitors
POST /api/v1/social/reddit/monitors
Create a Reddit monitor
DELETE /api/v1/social/reddit/monitors/:monitor_id
Delete a Reddit monitor
Social - LinkedIn
8 operations
GET /api/v1/social/linkedin/mentions
List LinkedIn mentions
GET /api/v1/social/linkedin/mentions/:mention_id
Get a LinkedIn mention
GET /api/v1/social/linkedin/monitors
List LinkedIn monitors
POST /api/v1/social/linkedin/monitors
Create a LinkedIn monitor
DELETE /api/v1/social/linkedin/monitors/:monitor_id
Delete a LinkedIn monitor
GET /api/v1/social/linkedin/monitors/:monitor_id
Get a LinkedIn monitor
PUT /api/v1/social/linkedin/monitors/:monitor_id
Update a LinkedIn monitor
POST /api/v1/social/linkedin/monitors/:monitor_id/poll
Poll a LinkedIn monitor
Social - Channels
1 operations
GET /api/v1/social/:platform/channels/:channel_id/profile
Get a channel profile for any supported social platform
Usage
1 operations
GET /api/v1/usage
Get the calling account's API usage, bucketed by key, endpoint group and day
Graph
1 operations
GET /api/v1/graph/timeline
Get a chronological event timeline for an entity in the temporal knowledge graph
Telemetry
22 operations
GET /api/v1/telemetry/dashboard

GET /api/v1/telemetry/destinations

POST /api/v1/telemetry/destinations

DELETE /api/v1/telemetry/destinations/{id}

PUT /api/v1/telemetry/destinations/{id}

GET /api/v1/telemetry/errors

GET /api/v1/telemetry/events

POST /api/v1/telemetry/funnel
Artifacts
6 operations
GET /api/v1/artifacts
List artifacts
POST /api/v1/artifacts
Register artifact
DELETE /api/v1/artifacts/:artifact_id
Delete artifact
GET /api/v1/artifacts/:artifact_id
Get artifact
POST /api/v1/artifacts/:artifact_id/download
Download artifact
GET /api/v1/artifacts/:artifact_id/url
Get artifact URL
Asset Definitions
5 operations
GET /api/v1/assets/definitions

POST /api/v1/assets/definitions

DELETE /api/v1/assets/definitions/{id}

GET /api/v1/assets/definitions/{id}

PUT /api/v1/assets/definitions/{id}
Lineage
7 operations
GET /api/v1/lineage/assets

POST /api/v1/lineage/assets

GET /api/v1/lineage/assets/{asset_id}

GET /api/v1/lineage/assets/{asset_id}/graph

GET /api/v1/lineage/consent

POST /api/v1/lineage/consent

POST /api/v1/lineage/edges
Observatory
4 operations
GET /api/v1/observatory/anomalies

POST /api/v1/observatory/compare

POST /api/v1/observatory/profile

GET /api/v1/observatory/profiles/{dataset_id}
ETL
14 operations
POST /api/v1/etl/compress
Compress or decompress
POST /api/v1/etl/fetch
Fetch remote artifact
POST /api/v1/etl/load
Bulk load Parquet to PostgreSQL
POST /api/v1/etl/parse
Parse JSON/CSV to Parquet
GET /api/v1/etl/pipelines
List ETL pipelines
POST /api/v1/etl/pipelines
Create ETL pipeline
DELETE /api/v1/etl/pipelines/:pipeline_id
Delete ETL pipeline
GET /api/v1/etl/pipelines/:pipeline_id
Get ETL pipeline
Query
10 operations
POST /api/v1/query
Execute a SQL query over Parquet files
POST /api/v1/query/arrow
Arrow-native query
POST /api/v1/query/describe
Describe schema of a Parquet file
POST /api/v1/query/export
Export query results
POST /api/v1/query/hybrid
Hybrid SQL query
POST /api/v1/query/register-table
Register DataFusion table
POST /api/v1/query/register-view
Register Parquet view
POST /api/v1/query/schema
Get view schema
SchemaRegistry
4 operations
GET /api/v1/schemas

POST /api/v1/schemas

POST /api/v1/schemas/validate

GET /api/v1/schemas/{name}/versions
ScheduledAudits
5 operations
GET /api/v1/scheduled-audits

POST /api/v1/scheduled-audits

DELETE /api/v1/scheduled-audits/{id}

GET /api/v1/scheduled-audits/{id}

PUT /api/v1/scheduled-audits/{id}
SEO Reports
2 operations
GET /api/v1/seo/reports

GET /api/v1/seo/reports/{report_id}
Cost Attribution
3 operations
POST /api/v1/cost/record

GET /api/v1/cost/records

GET /api/v1/cost/summary
Healing
6 operations
POST /api/v1/healing/auto-heal
Auto-heal pipeline
POST /api/v1/healing/diagnose
Diagnose pipeline
GET /api/v1/healing/patches
List patches
GET /api/v1/healing/patches/:id
Get patch
POST /api/v1/healing/patches/:id/apply
Apply patch
POST /api/v1/healing/patches/:id/rollback
Rollback patch
Governance
6 operations
GET /api/v1/governance/policies
List governance policies
POST /api/v1/governance/policies
Create governance policy
GET /api/v1/governance/policies/{id}
Get governance policy
POST /api/v1/governance/policies/{id}/comment
Comment on governance policy
POST /api/v1/governance/policies/{id}/review
Review governance policy
GET /api/v1/governance/queue
Get governance review queue
Incidents
7 operations
GET /api/v1/incidents
List incidents
POST /api/v1/incidents
Create incident
GET /api/v1/incidents/{id}
Get incident
PUT /api/v1/incidents/{id}
Update incident
POST /api/v1/incidents/{id}/resolve
Resolve incident
GET /api/v1/incidents/{id}/timeline
Get incident timeline
POST /api/v1/incidents/{id}/triage
Triage incident
Synthetic
6 operations
POST /api/v1/synthetic/generate

GET /api/v1/synthetic/guardrails/{dataset_id}

GET /api/v1/synthetic/jobs

GET /api/v1/synthetic/jobs/{id}

GET /api/v1/synthetic/operations

POST /api/v1/synthetic/verify
Workflow Templates
13 operations
GET /api/v1/workflow-templates
List workflow templates
POST /api/v1/workflow-templates
Create workflow template
DELETE /api/v1/workflow-templates/:id
Delete (archive) workflow template
GET /api/v1/workflow-templates/:id
Get template by ID
PUT /api/v1/workflow-templates/:id
Update workflow template
POST /api/v1/workflow-templates/:id/run
Run workflow template
GET /api/v1/workflow-templates/by-name/:name
Get template by name
GET /api/v1/workflow-templates/operations
List registered operations
OpenRate
4 operations
GET /api/v1/openrate/rates/compare
Compare healthcare rates
GET /api/v1/openrate/rates/discrepancies
Find pricing discrepancies
GET /api/v1/openrate/rates/pipeline-status
OpenRate pipeline status
GET /api/v1/openrate/rates/search
Search healthcare rates
OpenRate Admin
18 operations
POST /api/v1/openrate/admin/billing-codes
Upsert billing codes
POST /api/v1/openrate/admin/geo
Upsert geographic references
POST /api/v1/openrate/admin/hospitals
Upsert hospitals
POST /api/v1/openrate/admin/payers
Upsert payers
GET /api/v1/openrate/admin/pipelines
List OpenRate runs
GET /api/v1/openrate/admin/pipelines/:run_id
Get OpenRate run
POST /api/v1/openrate/admin/pipelines/bootstrap
Trigger OpenRate bootstrap
POST /api/v1/openrate/admin/pipelines/cms-discovery
Trigger CMS source discovery
Quality
8 operations
POST /api/v1/quality/classify
Classify text content using the taxonomy engine
POST /api/v1/quality/decontaminate
Check texts for benchmark contamination
POST /api/v1/quality/dedup

POST /api/v1/quality/filter

POST /api/v1/quality/gate
Run structured quality gate
GET /api/v1/quality/profiles/{dataset_id}

POST /api/v1/quality/score

GET /api/v1/quality/taxonomy
Get the taxonomy tree

Agent and LLM entrypoints