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.
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 Prompt (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:| Step | Description |
|---|---|
identifying | Understanding and analyzing your query |
generating_schema | Creating the data structure for results |
generating | Actively collecting and processing data from sources |
done | Research completed successfully |