Before you start
You need a Scraping Operations workspace and an API key. If you do not have an account yet, create one and generate an API key in the workspace.
1. Create an API key
Open API keys in your workspace, create a key named Quick start, and copy it to a secret manager. The full value is shown only once.
2. Send your first request
Submit a URL to the Scraping API. This request waits for a validated JSON result and is ideal for your first integration test.
cURL
curl -X POST https://api.nordicdevhouse.com/v1/scrape \
-H "Authorization: Bearer ndh_live_••••••••" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/products",
"formats": ["json"]
}'3. Inspect the response
A completed response includes a stable job ID, normalized data, record count, and request metadata. Persist the job ID so support and observability events can be correlated.
JSON
{
"id": "job_01J4N7BK8R5P",
"status": "completed",
"records": 24,
"data": [
{ "name": "Example product", "price": 129.90 }
]
}4. Move to production
Add timeouts, exponential backoff, idempotency, and webhook verification before increasing traffic. Monitor 429 and 5xx responses separately from permanent validation errors.