POST
/
trigger
Trigger Full Request
curl --request POST \
  --url https://api.brightdata.com/deep-lookup/v1/trigger \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "preview_id": "dld_meu4lhla1lj08i6p30",
  "result_limit": 100,
  "enrichments": "email"
}'
{
  "request_id": "ai_meu3z0171o8k9jc4dh",
  "status": "processing",
  "estimated_time": "2 minutes",
  "max_cost": "$100.00"
}
Alternative: Direct Trigger Skip preview and run research directly: 
curl -X POST https://api.brightdata.com/deep-lookup/v1/trigger \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find all micro SaaS companies with MRR greater than $1M",
    "result_limit": 50
  }'

Authorizations

​
Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Body

application/json

Response

200 - application/json

Research triggered successfully

The response is of type object.