Get one extraction result by its own ID

GET

/api/v1/extraction/results/by-id/{id}

Code sample: cURL

curl -X GET 'https://api.justcrawl.io/api/v1/extraction/results/by-id/00000000-0000-0000-0000-000000000001' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Fetches a single extraction row by its extraction ID. Use this when you already hold an extraction ID — from GET /api/v1/extraction/results or a warehouse delivery. To look one up by the job that produced it, use GET /api/v1/extraction/results/{jobId} instead; the /by-id/ segment exists precisely so the two lookups do not collide.

The response includes the scraped url alongside the extraction so rendering a result does not need a second request.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Extraction result ID.

Responses

200

The extraction result, plus the URL it came from.

Media typeapplication/json

Spelled out rather than $ref: ExtractionResult on purpose. The handler returns an explicit whitelist, deliberately omitting rawBlobKey (it leaks the platform bucket layout) and orgId (redundant for a request the caller already authenticated). Referencing the full schema would document two fields this endpoint never sends.

object

id

string format: uuid

jobId

string format: uuid

domain

string

dataType

string

schemaId

string

nullable

normalized

object

key

additional properties

any

qualityCompleteness

number

nullable

qualityValidation

number

nullable

qualityComposite

number

nullable

latencyMs

integer

nullable

deliveredAt

string format: date-time

nullable

createdAt

string format: date-time

url

Scraped URL; null if the source URL row was deleted.

string format: uri

nullable

hasRawBlob

Whether raw HTML is retained, without exposing its key.

boolean

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "jobId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "domain": "example",
  "dataType": "example",
  "schemaId": "example",
  "normalized": {},
  "qualityCompleteness": 1,
  "qualityValidation": 1,
  "qualityComposite": 1,
  "latencyMs": 1,
  "deliveredAt": "2026-04-15T12:00:00Z",
  "createdAt": "2026-04-15T12:00:00Z",
  "url": "https://example.com",
  "hasRawBlob": true
}

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

Extraction not found.

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}