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}

Keep polling until status is no longer "parsing".

Path Parameters

Name	Type	Required	Description
requestId	string (uuid)	yes	Task ID returned from the submit endpoint

Example Request

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

Responses

In progress — task is still being processed:

{
  "status": "parsing"
}

Ready — task completed successfully:

{
  "url": "https://example.com",
  "content": "<html>...</html>",
  "cookies": [],
  "success": true,
  "screenshot": null
}

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

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