Listing Extraction Jobs

Use the Jobs endpoint to view extraction jobs associated with your account.

This endpoint is useful when you need to find a previous job, retrieve a job ID, monitor running jobs, or review extraction history.

List Extraction Jobs

Use the following endpoint to retrieve extraction jobs.

GET /v1/extract/jobs

Request

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs" \
  -H "X-Api-Key: YOUR_API_KEY"

Response

response.json

{
  "jobs": [
    {
      "job_id": "0131f784-9037-4fdd-af9e-b8d445fe2d5f",
      "status": "completed",
      "url": "https://geonode.com/",
      "created_at": "2026-06-13T18:14:54.926869Z",
      "execution_time": 2297,
      "output": [
        "html"
      ]
    }
  ],
  "page": 1,
  "page_size": 100,
  "page_count": 1
}

Job Fields

Each job contains summary information about an extraction request.

Field	Description
`job_id`	Unique identifier for the extraction job
`status`	Current status of the extraction
`url`	URL that was extracted
`created_at`	Time the job was created
`execution_time`	Processing time in milliseconds
`output`	Output formats returned by the extraction

Filter Jobs

Filter by Status

Retrieve jobs with a specific status.

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs?status=completed" \
  -H "X-Api-Key: YOUR_API_KEY"

Supported values:

queued
processing
completed
failed
cancelled

Filter by Output Format

Retrieve jobs that generated a specific output format.

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs?output=html" \
  -H "X-Api-Key: YOUR_API_KEY"

Supported values:

html
markdown

Filter by URL

Retrieve jobs created for a specific URL.

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs?url=https://geonode.com/" \
  -H "X-Api-Key: YOUR_API_KEY"

Filter by Job ID

Retrieve a specific job from the results.

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs?job_id=0131f784-9037-4fdd-af9e-b8d445fe2d5f" \
  -H "X-Api-Key: YOUR_API_KEY"

Filter by Date Range

Retrieve jobs created within a specific time period.

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs?start_date=2026-06-01&end_date=2026-06-30" \
  -H "X-Api-Key: YOUR_API_KEY"

Pagination

Use pagination when working with a large number of extraction jobs.

Request

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/jobs?page=1&page_size=5" \
  -H "X-Api-Key: YOUR_API_KEY"

Pagination Fields

Field	Description
`page`	Current page number
`page_size`	Number of jobs returned per page
`page_count`	Total number of available pages

Retrieve Full Job Details

The Jobs endpoint returns summary information.

To retrieve the complete extraction result, use:

GET /v1/extract/{job_id}

Example:

request.sh

curl -X GET "https://scraper.geonode.io/v1/extract/0131f784-9037-4fdd-af9e-b8d445fe2d5f" \
  -H "X-Api-Key: YOUR_API_KEY"

Common Use Cases

Use this endpoint to:

Find a lost job ID
Review extraction history
Monitor running jobs
View completed extractions
Search jobs by URL
Retrieve recent extraction activity

Success

You now know how to list, search, and filter extraction jobs.

Next Steps

Continue to Extraction Workflows to learn how extraction features can be combined in real-world scenarios.

Listing Extraction Jobs

On this page