Request a collection

Use the Bright Data Marketplace API to request a collection. triggers a marketplace dataset collection and returns 200 OK with JSON status.

Endpoint: POST /datasets/request_collection

The initial step to define what data you want to collect. This is used when specifying the parameters for a new dataset collection like defining the dataset ID and type or when discovering new data or specifying URL collections.

Query Parameters

dataset_id · string · required

Dataset ID

type · string · required

value	description
discover_new
url_collection

POST body

inputs · array · required

Array - json

Body Example

[
  {
    "url":"https://www.linkedin.com/company/sendle/"
  },
  {
    "url":"https://www.linkedin.com/company/stallionexpress/"
  },
  {
    "url":"https://www.linkedin.com/company/595711"
  }
]

file · array · required

multipart - csv

curl -k "https://api.brightdata.com/datasets/request_collection?dataset_id=gd_l1vikfnt1wgvvqz95w&type=url_collection" -H "Authorization: Bearer API_KEY" -H "Content-Type: application/json" -d '[{"id":"user-id"}]'

{
    "request_id": "j_lsu5sdup1ggkc5umby"
}