Skip to main content
GET
/
scrape
/
{jobScrapeId}
{
  "data": "<string>",
  "timestamp": "<string>",
  "status": "<string>",
  "metrics": "<string>"
}

​
Overview

The /scrape/{jobScrapeId} endpoint retrieves the status and details of a specific scraping job. This is useful for monitoring long-running or asynchronous scraping operations.

​
Parameters

​
jobScrapeId
string
required
The unique identifier of the scraping job

​
Example Request

curl -X GET "https://api.scrapengine.io/api/v1/scrape/job_12345_abcde" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success Response (200)

​
data
string
Session data or status information
​
timestamp
string
Timestamp of the response in ISO 8601 format
​
status
string
Status of the operation (e.g., “success”, “processing”, “failed”)
​
metrics
string
Performance metrics and timing information
Example Response: 
{
  "data": "session",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "status": "success",
  "metrics": "100ms"
}

​
Error Responses

​
404
Job not found - The specified job ID does not exist
​
401
Unauthorized - Invalid or missing API key

​
Use Cases

  • Job monitoring: Check the status of asynchronous scraping jobs
  • Progress tracking: Monitor long-running scraping operations
  • Debugging: Investigate failed or stuck scraping jobs
  • Analytics: Collect performance metrics for scraping operations