Create a Bulk Job

Last updated: December 17, 2025

You can request data in bulk by creating a Bulk Job.

Endpoint

URL Method
https://api.intricately.com/api/v2/bulk_jobs POST
 

POST Body

[ DOMAIN1, DOMAIN2, DOMAIN3, ... ]

The response will contain a Job ID that you can use to view the status of the job and to fetch the results when the job completes.

📘  You may submit up to 10 domains per job during your Evaluation Period and up to 10,000 domains per job with an Enterprise License.

You will want to create multiple jobs if you have more domains than will fit into a single job.

❗️Large Bulk Jobs can take up to 3 hours to complete if there are many domains new to Intricately.

Code Examples

cURL

curl -XPOST https://api.intricately.com/api/v2/bulk_jobs 
-H "X-API-KEY: "
-d '
[
"nike.com",
"bbc.co.uk",
"macys.com"
]
'

#Response:
{
"status": "submitted",
"job_id": "",
"created_at": "2018-03-20T11:07:20-04:00"
}

Python

headers = { 'X-API-KEY': <YOUR_API_KEY> } 
payload = ['nike.com', 'bbc.co.uk', 'macys.com']

r = requests.post("https://api.intricately.com/api/v2/bulk_jobs", data=json.dumps(payload), headers=headers)
json_response = r.json()

#Response:
{
"status": "submitted",
"job_id": "",
"created_at": "2018-03-20T11:07:20-04:00"
}

Ruby

headers = { "X-API-KEY" => <YOUR_API_KEY>, content_type: :json, accept: :json } 
payload = ['nike', 'macy-s', 'netflix']
RestClient.post "https://api.intricately.com/api/v2/bulk_jobs", payload.to_json, headers

#Response:
{
"status": "submitted",
"job_id": "",
"created_at": "2018-03-20T11:07:20-04:00"
}