Get results of a background enrichment run (free)
get_enrichment_resultsPoll an async domain enrichment run started by enrich_domains to check status and page through result rows while the run is still in progress.
Instructions
WHAT: Read the status and result rows of an enrich_domains run started with waitForFinish=false, one page at a time. WHEN TO USE: after enrich_domains returned run.run_id, to poll until finished is true and page through the rows; rows already written are returned while the run is still RUNNING. WHEN NOT TO USE: to start an enrichment (enrich_domains) or to preview cost (normalize_domains). Cannot read runs of other Actors. BEHAVIOR: GET requests to the Apify API only (actor, run, dataset); never starts, aborts or re-bills a run. Typically <1 s. Poll every 10-30 s; a run works on 5 domains at a time, ~2-10 s each. COST: free; needs the APIFY_TOKEN that started the run. Reading charges no Actor event (the run was billed per enriched domain when it ran). RETURNS: run (run_id, status, finished) plus one page of the same rows enrich_domains returns; Errors: APIFY_TOKEN_MISSING, RUN_NOT_FOUND, RUN_NOT_FOR_THIS_ACTOR, APIFY_TOKEN_INVALID, APIFY_RUN_LOOKUP_FAILED / APIFY_DATASET_READ_FAILED (retryable). PARAMETERS: runId is run.run_id from enrich_domains (also in the Apify console URL). status is READY | RUNNING | SUCCEEDED | FAILED | ABORTED | TIMED-OUT; finished=true for the last four, after which total no longer changes. A FAILED or TIMED-OUT run still returns the rows it wrote. offset/limit page the rows in write order; total counts all rows written so far, so keep calling with nextOffset until it is null and finished is true. EXAMPLE: {"runId":"a1B2c3D4e5F6g7H8i"} -> {"run":{"status":"SUCCEEDED","finished":true},"count":1,"total":1,"items":[{"type":"domain","domain":"apify.com",...}]}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"runId": "<runId>"
},
"name": "get_enrichment_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional page size, integer 1-1000, default 100. Example: 250 | |
| runId | Yes | Required. Apify run ID (letters and digits) from enrich_domains run.run_id. Example: "a1B2c3D4e5F6g7H8i" | |
| offset | No | Optional integer >= 0, default 0; use nextOffset from the previous page. Example: 100 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run | Yes | run_id, status, finished, dataset_id, started_at, finished_at, console_url | |
| count | Yes | Rows in this page | |
| items | Yes | Dataset rows: type=domain or type=error | |
| total | Yes | Rows written by the run so far | |
| nextOffset | Yes | Offset of the next page, or null |