GET Get Results

Poll for job status and retrieve scraping results

Get Job Status & Results

GEThttps://api.anakin.io/v1/url-scraper/{id}

Retrieve the status and results of a scrape job. Use this to poll for completion after submitting a single URL or batch scrape request.


Path Parameters

ParameterTypeDescription
id requiredstringThe job ID returned from the submit endpoint

Response — Single URL Job

200 OK
{
  "id": "job_abc123xyz",
  "status": "completed",
  "url": "https://example.com",
  "jobType": "url_scraper",
  "country": "us",
  "html": "<html>...</html>",
  "cleanedHtml": "<div>...</div>",
  "markdown": "# Page content...",
  "generatedJson": { "data": {} },
  "cached": false,
  "error": null,
  "createdAt": "2024-01-01T12:00:00Z",
  "completedAt": "2024-01-01T12:00:05Z",
  "durationMs": 5000
}

Response — Batch Job

200 OK
{
  "id": "batch_abc123",
  "status": "completed",
  "jobType": "batch_url_scraper",
  "country": "us",
  "urls": ["https://example.com/page1", "https://example.com/page2"],
  "results": [
    {
      "index": 0,
      "url": "https://example.com/page1",
      "status": "completed",
      "html": "<html>...</html>",
      "cleanedHtml": "<div>...</div>",
      "markdown": "# Content...",
      "generatedJson": { "data": {} },
      "cached": false,
      "durationMs": 3000
    },
    {
      "index": 1,
      "url": "https://example.com/page2",
      "status": "failed",
      "error": "Connection timeout",
      "durationMs": 5000
    }
  ],
  "createdAt": "2024-01-01T12:00:00Z",
  "completedAt": "2024-01-01T12:00:10Z",
  "durationMs": 10000
}

Response Fields

FieldTypeDescription
statusstringpending, processing, completed, or failed
htmlstringRaw HTML content. Only present when completed.
cleanedHtmlstringCleaned HTML with non-essential elements removed.
markdownstringMarkdown version of the content.
generatedJsonobjectAI-extracted structured JSON. Only when generateJson: true was set.
cachedbooleantrue if served from cache.
errorstringError message. Only present when failed.
durationMsnumberProcessing time in milliseconds.
resultsarrayBatch jobs only — array of per-URL results.

Job Statuses

StatusDescription
pendingJob is queued
processingJob is being executed
completedResults are ready
failedJob encountered an error

Code Examples

curl -X GET https://api.anakin.io/v1/url-scraper/job_abc123xyz \
  -H "X-API-Key: your_api_key"

For polling patterns, see the Polling Jobs reference.