Batch Lookup
Look up backlinks for up to 50 domains in a single request, charged only for lookups that succeed.
https://api.rankparse.com/v1/batch2 credits (per successful domain, charged after the lookups)API keyRuns 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 stringsrequiredBetween 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
dataarrayOne result per valid input domain, in input order.
Show propertiesHide properties
domainstringThe normalized domain.
successbooleantrue when the lookup completed (including when it found nothing), false when it failed.
dataarrayUp 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.
totalintegerNumber of rows in this result's data.
errorstringOnly on failed results: the underlying error message.
credits_usedinteger2 times the number of successful lookups.
credits_remainingintegerYour 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_creditsand 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
successon 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: truewithdata: []andtotal: 0. - Rate limit: 60 requests per minute per key. A batch counts as one request.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_domains | domains is missing, not an array, empty, or contains no valid domains. |
| 400 | too_many_domains | More than 50 valid domains. The message reads max 50 domains per batch request. |
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 402 | insufficient_credits | Balance cannot cover the successful lookups. |
| 402 | spend_cap_reached | Your monthly spend cap is reached. |
| 429 | rate_limited | More than 60 requests in a minute. |
Validation errors are returned before any lookup and cost nothing. See Errors for the error body format.
Related
MCP tool: batch_lookup (accepts domains).