Documentation

API URL


POST /api/v1/web-scraping/scrape

Headers
Code
Content-Type: application/json
Body Parameters


Example Request

Code
POST https://datpaq.com/api/v1/web-scraping/scrape?api_key=your-api-key

Successful Response

Status
HTML
200 OK
Body
Code
{"success":true,"url":"https://example.com/article","title":"Article Title","text":"Plain text content...","excerpt":"Summary...","byline":null,"siteName":"Example","length":1200,"content":"<article>...</article>","markdown":"# Article Title"n"nPlain text content...","scrapeMetadata":{"timingMs":3500,"cached":false},"correlationId":"req_abc123"}

Error Response

Example
Code
400 ValidationError - Joi validation failure or SSRF-blocked or invalid URL: Request rejected before navigation
401 AuthenticationError - Missing or invalid API key at gateway layer: Authentication required
404 NotFound - Unknown endpoint path or async job ID not found: Resource not found
422 ExtractionError - Page loaded but content not extractable or scrape failed after navigation: Extraction failed after navigation
429 RateLimitError - Rate limit exceeded or browser pool saturated (POOL_SATURATED): Retry after retryAfter seconds
500 InternalError - Unexpected failure (message in development only): Internal server error
504 GatewayTimeout - Route-level timeout exceeded (35s scrape 60s map): Operation timed out

Last Updated:  May 4, 2026