Skip to content
Last updated
GEThttps://api.aitronos.com/v1/scrape/jobs

List all scraping jobs for the authenticated user.

NameTypeRequiredDescription
AuthorizationstringYesBearer token authentication

Query Parameters

ParameterTypeDefaultDescription
statusstringnullFilter by status: "pending", "processing", "completed", "failed", "cancelled"
limitinteger50Number of jobs to return (1-100)
offsetinteger0Pagination offset

Response

Status: 200 OK

FieldTypeDescription
jobsarrayArray of job objects
totalintegerTotal number of jobs matching filter
limitintegerLimit used in request
offsetintegerOffset used in request

Job Object

Each job in the array contains:

FieldTypeDescription
job_idstringUnique job identifier
statusstringJob status
urlstringTarget URL
extracted_dataarray|nullExtracted items (null if not completed)
error_messagestring|nullError message if failed
metadataobject|nullProcessing metadata
created_atstringCreation timestamp
completed_atstring|nullCompletion timestamp
Bash
curl -X GET "https://api.aitronos.com/api/v1/scrape/jobs?limit=20&offset=0" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response 200 OK

{
  "jobs": [
    {
      "job_id": "job_abc123",
      "status": "completed",
      "url": "https://example.com/page1",
      "extracted_data": [...],
      "metadata": {...},
      "created_at": "2024-12-16T10:30:00Z",
      "completed_at": "2024-12-16T10:30:02Z"
    },
    {
      "job_id": "job_def456",
      "status": "failed",
      "url": "https://example.com/page2",
      "extracted_data": null,
      "error_message": "Site blocked by anti-bot measures",
      "metadata": {...},
      "created_at": "2024-12-16T10:31:00Z",
      "completed_at": "2024-12-16T10:31:05Z"
    }
  ],
  "total": 45,
  "limit": 50,
  "offset": 0
}