Create a Bulk Job

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 -XPOST https://api.intricately.com/api/v2/bulk_jobs
  -H "X-API-KEY: <YOUR_API_KEY>"
  -d '
      [
        "nike.com",
        "bbc.co.uk",
        "macys.com"
      ]
  '

#Response:

{
  "status": "submitted",
  "job_id": "<JOB_ID>",
  "created_at": "2018-03-20T11:07:20-04:00"
}
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": "<JOB_ID>",
  "created_at": "2018-03-20T11:07:20-04:00"
}
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": "<JOB_ID>",
  "created_at": "2018-03-20T11:07:20-04:00"
}

Updated about a year ago


What's Next

List Bulk Jobs

Create a Bulk Job


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.