List extraction history for one URL item

GET

/api/v1/extraction/urls/{urlItemId}/extractions

curl --request GET \
  --url 'https://api.justcrawl.io/api/v1/extraction/urls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/extractions?page=1&pageSize=25' \
  --header 'Authorization: Bearer <token>'

• Production

Returns paginated extraction history for a single URL item — every prior extraction the org has on that URL, newest first, plus the canonical url and domain strings so the detail page can render headers without a second probe. Org-scoped; a 404 on a URL the caller doesn’t own is indistinguishable from a missing URL by design.

The indexingPending field counts this URL’s jobs that sit in extraction_done awaiting the bulk-writer flush (Phase 1 Lane D); the UI uses it to show “N indexing” above the table.

Authorizations

• bearerAuth

Parameters

Path Parameters

urlItemId

required

string format: uuid

Query Parameters

page

integer

default: 1 >= 1

pageSize

integer

default: 25 <= 100

Responses

200

Paginated extraction history for the URL item.

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

url

string

nullable

domain

string

nullable

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,
  "url": "example",
  "domain": "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

Resource not found

Media typeapplication/json

object

error

string

Example

{
  "error": "Workflow not found"
}

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}