Skip to main content
POST
https://api.crustdata.com
/
web
/
search
/
live
curl --request POST \ --url https://api.crustdata.com/web/search/live \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'x-api-version: <x-api-version>' \ --data ' { "query": "crustdata", "location": "US" } '
{ "success": true, "query": "crustdata", "timestamp": 1775195367446, "results": [ { "source": "web", "title": "Crustdata: Real-Time B2B Data Broker via API or Data Feed", "url": "https://crustdata.com/", "snippet": "Crustdata is a B2B data provider offering real-time company & people datasets. Access APIs and live signals to power sales and investment workflows.", "position": 1 }, { "source": "web", "title": "Crustdata: Real-time B2B data via simple APIs", "url": "https://www.ycombinator.com/companies/crustdata", "snippet": "Crustdata provides live company and people data via APIs and full dataset delivery.", "position": 2 }, { "source": "web", "title": "Crustdata (YC F24)", "url": "https://www.linkedin.com/company/crustdata", "snippet": "AI agents only grow revenue when they can act on the right data at the right time.", "position": 3 } ], "metadata": { "total_results": 7, "failed_pages": [], "empty_pages": [] } }

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Pass your API key as Authorization: Bearer <your_api_key>.

Headers

​
x-api-version
enum<string>
default:2025-11-01
required

API version to use. This endpoint currently requires 2025-11-01.

Available options:
2025-11-01
Example:

"2025-11-01"

Body

application/json

Search query and optional filters.

Request body for performing a web search.

​
query
string
required

The search query text. Keep queries concise and specific for better results. Supports standard search operators (e.g., site:, filetype:).

Required string length: 1 - 5000
Example:

"crustdata"

​
location
string | null

ISO 3166-1 alpha-2 country code for location targeting. Use this to get region-specific search results. Valid values include US, CA, MX, BR, AR, CL, CO, PE, VE, GB, DE, FR, IT, ES, PT, NL, BE, CH, AT, PL, SE, NO, DK, FI, IE, RU, UA, CZ, GR, TR, RO, HU, JP, CN, KR, IN, ID, TH, VN, MY, SG, PH, TW, HK, SA, AE, IL, EG, AU, NZ, ZA, NG, KE.

Example:

"US"

​
sources
enum<string>[] | null

List of search sources to query. If omitted, all sources are searched. Use specific sources to narrow results.

A search source type.

Available options:
news,
web,
scholar-articles,
scholar-articles-enriched,
scholar-author,
ai,
social
Example:
["news", "web"]
​
site
string | null

Restrict search results to a specific site domain. For example, use "linkedin.com/company" to find company LinkedIn pages, or "site:github.com" for developer profiles.

Maximum string length: 500
Example:

"example.com"

​
start_date
integer | null

Unix timestamp (seconds since epoch) for the start date filter. Must be less than end_date if both are provided.

Example:

1728259200

​
end_date
integer | null

Unix timestamp (seconds since epoch) for the end date filter. Must be greater than start_date if both are provided.

Example:

1730937600

​
human_mode
boolean
default:false

Whether to use a browser-like retrieval path when standard access is blocked.

Example:

false

​
page
integer
default:1

Number of search result pages to return.

Required range: x >= 1
Example:

1

Response

Successful search response with results.

Response object for a web search request.

​
success
boolean
required

Whether the search was executed successfully.

Example:

true

​
query
string
required

The original search query that was submitted.

Example:

"crustdata"

​
timestamp
integer
required

Unix timestamp in milliseconds when the search was performed.

Example:

1762908151599

​
results
object[]
required

Array of search result entries.

Example:
[
  {
    "source": "web",
    "title": "Crustdata: Real-Time B2B Data Broker via API or Data Feed",
    "url": "https://crustdata.com/",
    "snippet": "Crustdata is a B2B data provider offering real-time company & people datasets.",
    "position": 1
  }
]
​
metadata
object
required

Metadata about the search results.