---
title: "Download Results of Bulkjob"
method: POST
path: "/kg/v3/enhance/bulk/{bulkjobId}"
tags: ["Bulk Enhance"]
---

# Download Results of Bulkjob

`POST /kg/v3/enhance/bulk/{bulkjobId}`

Download the result of a completed Enhance Bulkjob

## Path parameters

- `bulkjobId` string, required

## Request body

- BulkjobResultPostRequest
  - `head` integer — Return first n results
  - `from` integer — Return first n results
  - `size` integer — Maximum number of results to return. Should be specified with from parameter.
  - `onlyMatches` boolean — Return only records that have a match
  - `format` 'json' | 'jsonl' | 'csv' | 'xls' | 'xlsx' — Export format
  - `exportspec` string — The spec defines the columns to export. This is applicable for csv, xls and xslx formats.<br><br>Export spec specifies how to export the entity JSON to a csv. A simple export spec looks like `name;summary`. To specify more complex export spec, including specifying how many of a list of `industries` to return, or the ideal `employment` record, see [Exporting Columnar Format](https://docs.diffbot.com/reference/exporting-csv) and [JsonPath Filtering](https://docs.diffbot.com/docs/en/filtering-fields).
  - `exportfile` string — File name of the export file
  - `exportseparator` string — Separator for multi-value fields when exporting columnar results
  - `exportquery` boolean — Prefixes the enhance query parameters to the CSV export result
  - `filter` string — Semi-colon separated path filter to filter response json. You can use a simple dot notation `skills.name` or a JsonPath expression such as such as `$.name;$.locations.country.name`. For more advanced options, see [JsonPath Filtering](https://docs.diffbot.com/reference/filtering-fields) for syntax.
  - `filterExclude` string — Semi-colon separated path filter to filter and exclude data from response json. You can use a simple dot notation `skills.name` or a JsonPath expression such as such as `$.name;$.locations.country.name`. For more advanced options, see [JsonPath Filtering](https://docs.diffbot.com/docs/en/kg-filtering) for syntax.
  - `wait` integer — Seconds to wait for bulkjob results to export. Results will continue to export in the background. To only trigger an export, use 0.

## Response `200`

Result data. Depends on format (default is json lines).

- JsonNode

## Other responses

- `201` — Bulkjob is still executing or is stopped
- `400` — Invalid bulkjobId
- `401` — Token not specified or other client errors
- `404` — Bulkjob not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/diffbot/apis/web-search.md) · [All operations](https://skmtc.net/diffbot/apis/web-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/diffbot/web-search/versions/8b88d7dabe63/schema)