Execution

Indexing

Submit URLs to IndexNow and, when configured, the Google Indexing API, and stream crawler visits from your server logs. Submission confirms delivery; it does not guarantee indexing or ranking.

POST/api/v1/indexing/submissionsRead & write key

Submit URLs (1 credit per URL)

Authentication: Bearer API key in the Authorization header.

Parameters
Parameter	In	Type	Description
urls*	body	string[]	Up to 10,000 URLs
source	body	manual \| list \| sitemap \| backlinks	Default list
websiteId	body	string	Detected from URLs when omitted

Request

curl -X POST "https://rankspire.tech/api/v1/indexing/submissions" \
  -H "Authorization: Bearer $RANKSPIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "urls": ["https://example.com/new-page"] }'

Response

{ "data": { "id": "cm1sub…", "status": "queued", "urlCount": 1, "invalid": [] } }

402 payment_required not enough credits

GET/api/v1/indexing/submissionsRead key

List submissions

Authentication: Bearer API key in the Authorization header.

Request

curl "https://rankspire.tech/api/v1/indexing/submissions" \
  -H "Authorization: Bearer $RANKSPIRE_KEY"

Response

{ "data": [{ "id": "cm1sub…", "status": "completed", "urlCount": 120, "completedCount": 118, "failedCount": 2 }] }

GET/api/v1/indexing/submissions/{id}Read key

Submission with per-URL results

Authentication: Bearer API key in the Authorization header.

Request

curl "https://rankspire.tech/api/v1/indexing/submissions/cm1site9x0001" \
  -H "Authorization: Bearer $RANKSPIRE_KEY"

Response

{ "data": { "id": "cm1sub…", "urls": [{ "url": "https://example.com/new-page", "status": "crawled", "httpStatus": 202, "lastCrawledAt": "2026-10-02T09:12:44Z" }] } }

POST/api/v1/crawler-visitsRead & write key

Ingest server log lines

Authentication: Bearer API key in the Authorization header.

Parameters
Parameter	In	Type	Description
visits*	body	object[]	url, userAgent, status, responseMs?, ip?, timestamp? — up to 5,000 per request

Request

curl -X POST "https://rankspire.tech/api/v1/crawler-visits" \
  -H "Authorization: Bearer $RANKSPIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "visits": [{ "url": "https://example.com/new-page", "userAgent": "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)", "status": 200, "responseMs": 184 }] }'

Response

{ "data": { "accepted": 1, "ignored": 0 } }

GET/api/v1/crawler-visitsRead key

Recent crawler visits

Authentication: Bearer API key in the Authorization header.

Parameters
Parameter	In	Type	Description
bot	query	string	googlebot, bingbot, gptbot, claudebot…
days	query	integer	Default 7

Request

curl "https://rankspire.tech/api/v1/crawler-visits" \
  -H "Authorization: Bearer $RANKSPIRE_KEY"

Response

{ "data": [{ "url": "https://example.com/", "bot": "googlebot", "botType": "search", "httpStatus": 200, "visitedAt": "…" }] }