Measure how many referring domains the pages ranking on Google page 1 have, for each keyword in a market: median and q25 to q75 range of the top 10, compared with positions 11 to 30, with a significance test. PAID: 1 credit per unique keyword, charged at launch, including cached results; a failed analysis is not refunded. Check get_account first and tell the user the cost. Call it sequentially (one launch at a time per account; a concurrent launch gets 429 launch_in_progress, retry after a few seconds); get_batch can run in parallel. Returns the batch: HTTP 201 (MCP http_status 201) = new batch, charged; 200 = idempotent replay of the existing batch, nothing charged. If status is still running, call get_batch with wait=40.

post/api/v1/batches

Request

  • Base URL: https://12backlinks.com
  • URL: https://12backlinks.com/api/v1/batches
  • Auth: HTTP bearer

Request body

domainstring

Default Google domain for every item. Default google.fr.

langstring

Default language for every item. Default fr.

namestring

Optional batch name, shown in the 12Backlinks history.

waitinteger

Seconds to wait for the results before answering (0 to 45). Default 0 over REST, 40 over MCP. One analysis takes about 15 seconds.

idempotency_keystring

Recommended. 16 to 128 characters [A-Za-z0-9_-]. Reuse the SAME key with the SAME input after a timeout: the existing batch is returned without a new charge. Same key with a different input: 409.

Response

Idempotent replay: same idempotency_key and same input, existing batch returned, nothing charged.

batch_idstring
namestring nullable
source'api' | 'ui'
status'running' | 'done' | 'partial'
created_atstring date-time
credits_chargedinteger nullable

Read from the credit ledger; null when it cannot be read (unknown, not zero).

next_stepstring

What to do next, e.g. call get_batch with wait=40 while status is running.

Changes

No recorded changes to this operation across all 1 revision of this API.