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": "<string>",
  "query": "<string>",
  "status": "pending",
  "sample_data": [
    {}
  ],
  "columns": [
    {}
  ],
  "result_limit": 123
}

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
Example:

"dld_meu4lhla1lj08i6p30"

Response

200 - application/json

Preview details

​
preview_id
string
Example:

"dld_meu4lhla1lj08i6p30"

​
query
string
Example:

"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
Example:

"completed"

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

10