Start an export job
Export every referring or outbound domain of a site as a CSV or JSONL file, however long the list.
POSThttps://rankfield.dev/v1/jobs
Use an export job for lists of any size. For up to 50,000 rows, ?format=csv on List All Referring Domains is quicker.
Parameters
Headers
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
Authorization | string | Yes | – | Bearer followed by your API key. See Authentication. |
Body
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
kind | string | Yes | – | referrers-export (domains linking to it) or outbound-export (domains it links to). |
domain | string | Yes | – | The domain, as for Get Site Strength. |
format | string | No | csv | csv or jsonl. |
minSiteStrength | integer | No | 0 | Only domains with at least this Site Strength, 0–100. |
sort | string | No | strength_desc | strength_desc or strength_asc. |
Response
202 with the job's id, status (queued), totalGraphRelationships, expiresAt and statusUrl. Follow statusUrl with Get an export job.
For a domain that isn't in our link graph yet, the job is created already completed, with "inGraph": false and no rows: the file holds only the CSV header (or nothing, for JSONL).
Errors
| Status | When |
|---|---|
| 400 | kind, domain, format, minSiteStrength or sort is invalid. |
| 401 | No valid API key. |
| 409 | This key already has an export running. Wait for it to finish. |
| 503 | The export service or the graph index is unavailable. Retry later. |
Limits
No daily limit; one export job at a time per key. Finished exports are kept for 7 days.
MCP
On the MCP server, the tool for this is start_domain_export.