Batch Lookup

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, no scoring). Data comes from the pre-processed link graph snapshot (see Response format).

Request

Body

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

Notes on the list:

• Domains are 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.

Example

curl -X POST "https://api.rankparse.com/v1/batch" \
  -H "X-API-Key: rp_your_key" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["stripe.com", "github.com", "smartify.in"]}'

import requests

res = requests.post(
    "https://api.rankparse.com/v1/batch",
    json={"domains": ["stripe.com", "github.com", "smartify.in"]},
    headers={"X-API-Key": "rp_your_key"},
    timeout=120,
)
res.raise_for_status()
body = res.json()
for item in body["data"]:
    if item["success"]:
        print(item["domain"], item["total"])
    else:
        print(item["domain"], "failed:", item["error"])
print("charged", body["credits_used"])

const res = await fetch("https://api.rankparse.com/v1/batch", {
  method: "POST",
  headers: {
    "X-API-Key": "rp_your_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ domains: ["stripe.com", "github.com", "smartify.in"] }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, credits_used } = await res.json();
for (const item of data) {
  console.log(item.domain, item.success ? item.total : item.error);
}
console.log("charged", credits_used);

Response

{
  "data": [
    {
      "domain": "stripe.com",
      "data": [
        {
          "from_domain": "techcrunch.com",
          "from_url": "https://techcrunch.com/2025/11/04/stripe-launches-new-billing-tools/",
          "to_url": "https://stripe.com/billing",
          "anchor_text": "Stripe Billing",
          "rel": null,
          "link_type": "hyperlink",
          "crawled_at": "2026-02-10"
        }
      ],
      "total": 1,
      "success": true
    },
    {
      "domain": "github.com",
      "data": [],
      "total": 0,
      "success": true
    },
    {
      "domain": "smartify.in",
      "data": [],
      "total": 0,
      "success": false,
      "error": "R2 SQL timeout after 45000ms"
    }
  ],
  "credits_used": 4,
  "credits_remaining": 996
}

Response fields

Top level:

Each result in data:

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 x 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 of the batch: 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

See Errors for the full list and the error body format.

Related

MCP tool: batch_lookup (accepts domains).