Retrieve Bulk Extract Job Data ​

GEThttps://api.diffbot.com/v3/bulk/data

To download the results of your bulk extracted URLs, make a GET request to this endpoint. By default the complete extracted JSON data will be downloaded.

See also: Creating a Bulk Job and Managing a Bulk Job

Download a URL Report ​

The URL Report is a CSV file that provides a diagnostic on every URL run through a Bulk API job and does not include extraction output. To retrieve the URL report, pass type=urls to your GET request on this endpoint.

Example ​

bash
curl --get https://api.diffbot.com/v3/bulk/data \
  --data-urlencode "token=<DIFFBOT_TOKEN>" \
  --data-urlencode "name=bulkTest"

API Definition

Generated from v1.1 of the Bulk Extract API OpenAPI specification.

Download the extracted results of a bulk job

Request

Authentication
tokenquery
Cache and insert token into example requests (15d expiry)
Query parameters
namestring required

Name of the bulk job whose data you wish to download.

formatstring

Request format=csv to download the extracted data in CSV format (default: json). Note that CSV files will only contain top-level fields.

typestring

Request type=urls to retrieve the URL Report (CSV).

numstring

Pass an integer value (e.g. num=100) to request a subset of URLs, most recently processed first.

Example request

bash
curl --request GET \
  --url 'https://api.diffbot.com/v3/bulk/data?name=%3Cname%3E&token=<DIFFBOT_TOKEN>' \
  --header 'Accept: application/json'

Response

200The bulk job's extracted data
colstring

Name of the Crawl or Bulk job this record was extracted from

parentUrlstring

Immediate parent contained a link to this record

pageUrlstring

The URL of this record

idinteger

A reference

typestring

A standard entity type assigned either on job creation or classified by Analyze API. All other keys on this job record follow the ontology set by its type.

tokenstring

Your token

timestampstring

Time when record was crawled, in ISO 8601 format.

json
[
    {
        "col": "docs-bulkdata-sample",
        "parentUrl": "https://example.com",
        "pageUrl": "https://example.com/",
        "id": 6526070754824580571,
        "type": "other",
        "title": "Example Domain",
        "content": "Example Domain \n\n# Example Domain \n\nThis domain is for use in documentation examples without needing permission. Avoid use in operations. \n\n[Learn more](https://iana.org/domains/example)",
        "token": "<REDACTED>",
        "timestamp": "2026-07-24T23:03:01Z"
    }
]
400No job found by that name
errorCodeinteger
errorstring
json
{
    "errorCode": 400,
    "error": "No collection record"
}