Skip to Content

Batch Lookup

Look up backlinks for up to 50 domains in a single request, charged only for lookups that succeed.

POSThttps://api.rankparse.com/v1/batch2 credits (per successful domain, charged after the lookups)API key

Runs a backlinks lookup for each domain in your list and returns one result per domain. Use it to screen a list of prospects or competitors without making dozens of separate calls. Each lookup is the same as Backlinks with its defaults (limit=100, sort=importance, no scoring). Data comes from the pre-processed link graph snapshot (see Response format).

Body parameters

Send JSON with a Content-Type: application/json header.

domainsarray of stringsrequired

Between 1 and 50 domains, for example ["stripe.com", "github.com"]. Each entry is lowercased and trimmed. Entries that are not valid domains (no dot, illegal characters) are silently dropped; if none are valid, the call fails with invalid_domains. The limit of 50 applies after invalid entries are dropped. Duplicates are not removed: a domain listed twice is looked up and charged twice.

There are no per-domain options. To use limit, sort, score or filters, call Backlinks directly.

Response

dataarray

One result per valid input domain, in input order.

Show properties
domainstring

The normalized domain.

successboolean

true when the lookup completed (including when it found nothing), false when it failed.

dataarray

Up to 100 backlink rows, the same shape as Backlinks without scoring, including the possible aggregated row shape. Empty on failure or when there is no data.

totalinteger

Number of rows in this result's data.

errorstring

Only on failed results: the underlying error message.

credits_usedinteger

2 times the number of successful lookups.

credits_remaininginteger

Your balance after this call.

Behavior and limits

  • Cost: 2 credits per successful domain. Failed domains (success: false) are not charged. The total is deducted in one atomic step after all lookups finish, so the response shows the real amount.
  • Insufficient credits: because charging happens after the lookups, a balance that cannot cover the successful lookups returns 402 insufficient_credits and nothing is deducted. Keep a balance of at least 2 times the number of domains.
  • Partial failure: one failing domain does not fail the request. Check success on every result and retry failed domains separately.
  • Concurrency: up to 6 lookups run in parallel, so a full batch of 50 can take a while. Use a generous client timeout.
  • No caching: each call runs its lookups fresh, unlike the single-domain endpoints.
  • Empty results: a domain with no data returns success: true with data: [] and total: 0.
  • Rate limit: 60 requests per minute per key. A batch counts as one request.

Errors

HTTPCodeWhen
400invalid_domainsdomains is missing, not an array, empty, or contains no valid domains.
400too_many_domainsMore than 50 valid domains. The message reads max 50 domains per batch request.
401invalid_api_keyMissing, invalid or revoked API key.
402insufficient_creditsBalance cannot cover the successful lookups.
402spend_cap_reachedYour monthly spend cap is reached.
429rate_limitedMore than 60 requests in a minute.

Validation errors are returned before any lookup and cost nothing. See Errors for the error body format.

MCP tool: batch_lookup (accepts domains).