Skip to main content
GET
/
preview
/
{id}
Get Preview Data
curl --request GET \
  --url https://api.brightdata.com/datasets/deep_lookup/v1/preview/{id} \
  --header 'Authorization: Bearer <token>'
{
  "preview_id": "dld_meu4lhla1lj08i6p30",
  "query": "Find all AI startups founded after 2020 with more than 50 employees",
  "status": "completed",
  "sample_data": {
    "company_name": "Anthropic",
    "website": "anthropic.com",
    "founded_year": 2021,
    "employee_count": 160
  },
  "columns": [
    {
      "company_name": "Anthropic",
      "website": "anthropic.com",
      "founded_year": 2021,
      "employee_count": 160
    }
  ],
  "result_limit": 10
}

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

Path Parameters

id
string
required
Examples:

"dld_meu4lhla1lj08i6p30"

Response

200 - application/json

Preview details

preview_id
string
Examples:

"dld_meu4lhla1lj08i6p30"

query
string
Examples:

"Find all AI startups founded after 2020 with more than 50 employees"

status
enum<string>
  • queued - Request is waiting to be processed
  • running - Preview is being generated
  • completed - Results ready
  • failed - Error occurred
Available options:
pending,
processing,
completed,
failed
Examples:

"completed"

sample_data
object[]
Examples:
{
"company_name": "Anthropic",
"website": "anthropic.com",
"founded_year": 2021,
"employee_count": 160
}
columns
object[]
Examples:
[
{
"company_name": "Anthropic",
"website": "anthropic.com",
"founded_year": 2021,
"employee_count": 160
}
]
result_limit
integer
Examples:

10

I