URL Scraper

Receiving URL Scraping Results

Poll this endpoint to retrieve the result of a submitted URL scraping task.

Endpoint

GET /api/parsing/v1/result/url/{requestId}

Repeat the request every few seconds until status is "ready" or "cancelled". While the task is waiting in the queue or being processed, status is "queued" or "parsing" — see Task statuses.

Path Parameters

Name	Type	Required	Description
requestId	string (uuid)	yes	Task ID — the `id` field returned by the submit endpoint

Example Request

curl https://app.scrapering.com/api/parsing/v1/result/url/YOUR_REQUEST_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

Responses

In progress — task is waiting in the queue ("queued") or being processed ("parsing"):

{
  "status": "parsing",
  "requestId": "ac9c7911-b32c-4890-a850-227003ee2d35"
}

Ready — task completed successfully:

{
  "status": "ready",
  "requestId": "ac9c7911-b32c-4890-a850-227003ee2d35",
  "data": {
    "url": "https://scrapering.com",
    "content": "<html>...</html>",
    "cookies": [],
    "success": true,
    "screenshot": null
  },
  "respondedAt": "2026-05-08T10:00:03.240Z"
}

Field	Type	Description
status	string	`"ready"` when complete
requestId	string	Task ID
data.url	string	The URL that was scraped
data.success	boolean?	Whether the page was scraped successfully
data.content	string?	Raw HTML of the page. Present when `output.html` is `true` (default)
data.contentMarkdown	string?	Markdown version of the page. Present when `output.markdown` is `true`
data.contentText	string?	Plain text version of the page. Present when `output.text` is `true`
data.contentJSON	object?	Structured JSON representation of the page. Present when `output.json` is `true`
data.cookies	array?	Cookies collected from the page
data.headers	object?	Response headers. Present when `parseHeaders` is `true`
data.screenshot	string?	Base64-encoded screenshot. Present when `takeScreenshot` is `true`
data.proxy	string?	Proxy used for the request
data.time	string?	Time taken to complete the scraping
data.error	string?	Short error message if scraping failed
data.errorFull	string?	Full error details if scraping failed
data.hasBadMarksErr	string?	Indicates a bad marks error was detected
respondedAt	string	ISO 8601 timestamp of completion

data.screenshot contains a base64-encoded image when takeScreenshot was set to true in the request, otherwise null.

Important! Screenshot is stored for 1 hour after the scrape.
Scraped content is stored for 7 days after the scrape.
Save the results on your side so you don't lose them.

Next steps

Webhook — receive the result via callback instead of polling
Creating a task — back to the submit endpoint reference