List extraction history for a URL

GET

/api/v1/urls/{id}/extractions

Code sample: cURL

curl -X GET 'https://api.justcrawl.io/api/v1/urls/00000000-0000-0000-0000-000000000001/extractions?page=1&pageSize=25' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Returns one row per completed extraction for this URL, ordered newest first. fieldTypes is derived from the latest published schema for the URL’s (domain, dataType) pair — it tells the UI (and SDK consumers) which column to render as a number vs text vs link. indexingPending surfaces the count of jobs sitting in the extraction_done interim state waiting on the BI bulk-writer flush (Phase 1 Lane D); when non-zero the table is showing a stale snapshot and the dashboard overlays a “settling” badge. pageSize is capped at 200 here (not 100 like /urls) because extraction rows are the unit of analyst pagination.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

URL item ID.

Query Parameters

page

integer

default: 1 >= 1

pageSize

integer

default: 25 <= 200

Responses

200

Paginated extraction history with field-type hints.

Media typeapplication/json

object

items

Array<object>

object

id

string format: uuid

orgId

string format: uuid

jobId

string format: uuid

domain

string

schemaId

string

nullable

dataType

string

normalized

object

key

additional properties

any

rawBlobKey

Internal storage key for the raw HTML blob.

string

nullable

qualityCompleteness

number

qualityValidation

number

qualityComposite

number

latencyMs

integer

nullable

deliveredAt

string format: date-time

nullable

createdAt

string format: date-time

total

integer

fieldTypes

object

key

additional properties

string

indexingPending

Count of this URL’s jobs sitting in extraction_done awaiting the bulk-writer flush (Phase 1 Lane D).

integer

Example^generated

{
  "items": [
    {
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "orgId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "jobId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "domain": "example",
      "schemaId": "example",
      "dataType": "example",
      "normalized": {},
      "rawBlobKey": "example",
      "qualityCompleteness": 1,
      "qualityValidation": 1,
      "qualityComposite": 1,
      "latencyMs": 1,
      "deliveredAt": "2026-04-15T12:00:00Z",
      "createdAt": "2026-04-15T12:00:00Z"
    }
  ],
  "total": 1,
  "fieldTypes": {
    "additionalProperty": "example"
  },
  "indexingPending": 1
}

401

Missing or invalid authentication token

Media typeapplication/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media typeapplication/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

404

URL not found.

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}