---
title: "IP bulk search download"
method: POST
path: "/bulk-search/ip/download"
tags: ["Bulk Search"]
---

# IP bulk search download

`POST /bulk-search/ip/download`

Initiates the creation of the file with data about IPs that matched the search query. When the file is created, it will be available for download. On the successful call, returns the unique identifier that represents the file creation process. The file creation is an asynchronous process, because the amount of data that should be exported to the file and the export duration is hard to predict. The call to this endpoint just initiates the file creation. To check the file status and get the download link, send a GET request to the `/v4/data/account/downloads/` API endpoint with the identifier returned by this endpoint. The number of rows available for download is determined by the subscription plan.

## Request body

- SearchBulkIPDownloadRequest
  - `column_list` string[], required — List of columns to download. Supported values: ```ip, ptr_record_value, spyse_score, country, as_number, as_organization, isp, osh, city, open_ports_count, open_ports, abuses_score```
  - `description` string — An optional field with a short file description. Max length: 254 characters.
  - `file_format` 'csv' | 'ndjson', required — The file format to use for the file creation. Supported values: ```ndjson```, ```csv```.
  - `ip_list` string[], required — The list of valid IPv4 addresses to search for.
  - `rows_count` integer — The number of rows the user wants to receive in the current download request.

## Response `200`

Operation successful

- DownloadResponse
  - `data` DownloadResponseData
    - `download_id` integer — Unique identifier that represents the file. Use this identifier to check the file creation status and get the download link at the `/v4/data/account/downloads/` API endpoint.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/spyse/apis/data-api.md) · [All operations](https://skmtc.dev/spyse/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spyse/data-api/revisions/fd05b83ed2c5/schema)