Jobs
Listing Jobs
The Scraper API allows you to retrieve previously created jobs.
Listing jobs is useful for monitoring activity, reviewing completed requests, or locating a specific job ID.
List Jobs
Use the list jobs endpoint provided by the API.
For example:
GET /v1/extract/jobsor
GET /v1/batch/jobsor
GET /v1/crawl/jobsThe response returns a paginated collection of jobs.
Filter Results
Most job endpoints support filtering and pagination.
Common query parameters include:
| Parameter | Description |
|---|---|
status | Return only jobs with a specific status. |
start_date | Return jobs created after a specific date. |
end_date | Return jobs created before a specific date. |
page | Page number to retrieve. |
page_size | Number of jobs returned per page. |
Use these filters to quickly locate the jobs you need.
Pagination
Large job histories are split into pages.
Increase or decrease page_size depending on how many results you want returned in each request.
Common Use Cases
Listing jobs is useful for:
- Viewing recent activity
- Finding completed jobs
- Monitoring failed jobs
- Reviewing processing history
- Building dashboards or reporting tools