REST API
Create a key under Settings → API keys (Starter plan and above). Send it as
Authorization: Bearer cae_…. A key acts for the workspace it was created in.
Requests that create work accept an Idempotency-Key header, so a retried request never queues the same links twice.
Going over your plan's backlink allowance returns 402 with the reason.
/v1/campaigns
Create a campaign for one of your sites.
curl -X POST https://crawler.theitsglobal.com/api/v1/campaigns \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"project_id": 12, "name": "October guest posts"}'
/campaigns/{id}/urls
Add backlink URLs to a campaign (up to 10,000 per call).
curl -X POST https://crawler.theitsglobal.com/api/campaigns/{id}/urls \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"urls": ["https://blog.example.com/post", "https://news.example.org/story"]}'
/campaigns/{id}/urls/upload
Upload a CSV or text file of URLs (multipart field "file").
curl -X POST https://crawler.theitsglobal.com/api/campaigns/{id}/urls/upload \
-H "Authorization: Bearer $API_KEY"
/campaigns/{id}
Campaign status and counters.
curl -X GET https://crawler.theitsglobal.com/api/campaigns/{id} \
-H "Authorization: Bearer $API_KEY"
/campaigns/{id}/urls
Every URL in a campaign with its link verdict, rel, anchor and index status.
curl -X GET https://crawler.theitsglobal.com/api/campaigns/{id}/urls \
-H "Authorization: Bearer $API_KEY"
/urls/{id}
One URL in full.
curl -X GET https://crawler.theitsglobal.com/api/urls/{id} \
-H "Authorization: Bearer $API_KEY"
/urls/{id}/timeline
Everything that ever happened to a URL, oldest first.
curl -X GET https://crawler.theitsglobal.com/api/urls/{id}/timeline \
-H "Authorization: Bearer $API_KEY"
/campaigns/{id}/stats
Aggregate numbers for dashboards.
curl -X GET https://crawler.theitsglobal.com/api/campaigns/{id}/stats \
-H "Authorization: Bearer $API_KEY"
/campaigns/{id}/pause
Pause, resume, cancel or retry a campaign (also /resume, /cancel, /retry).
curl -X POST https://crawler.theitsglobal.com/api/campaigns/{id}/pause \
-H "Authorization: Bearer $API_KEY"
/alerts
Recent link changes in this workspace, newest first.
curl -X GET https://crawler.theitsglobal.com/api/alerts \ -H "Authorization: Bearer $API_KEY"
Webhooks
Add a webhook under Alerts. We POST JSON for each link change
(link.lost, link.nofollow,
link.restored, link.found,
page.gone, link.indexed).
Each request carries X-Signature: sha256=…, an HMAC of the raw body with your webhook's secret. Reject anything that does not match.