Skip to main content

​
Getting Started

Base URL: https://api.brightdata.com/datasets/deep_lookup/v1 Authentication: All API requests require authentication using your API key in the request headers. 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.brightdata.com/datasets/deep_lookup/v1/preview

​
Core Workflow

The Deep Lookup API follows a simple workflow designed for maximum flexibility and cost control:

Create Preview

Start a preview to test your query with sample results.

Get Preview Data

Retrieve the preview results once processing is complete

Enhance Query (Optional)

Refine your query based on preview results

Trigger Full Request

Execute the research with your desired parameters

Get Results

Retrieve your structured data in JSON or CSV format

​
Understanding Column Types

When creating requests with specifications, you need to define column types:

​
Column Type: enrichment

Adds data attributes without filtering results.
Examples:
  • Company revenue
  • Contact information
  • Social profiles

​
Column Type: constraint

Filters results based on criteria. Only entities matching ALL constraints are included.
Examples:
  • Must be a startup
  • Revenue over $10M
  • Founded after 2020

​
Processing Steps

When monitoring request progress, the step field indicates the current processing phase:
StepDescription
identifyingUnderstanding and analyzing your query
generating_schemaCreating the data structure for results
generatingActively collecting and processing data from sources
doneResearch completed successfully

​
Webhooks (Coming Soon)

Configure webhooks to receive notifications when research completes: 
{
  "webhook_url": "https://your-app.com/webhook",
  "events": ["request.completed", "request.failed"]
}