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", "geolocation": "US" } '
{ "success": true, "query": "crustdata", "timestamp": 1762908151599, "results": [ { "title": "Crustdata - B2B Data Platform", "url": "https://www.crustdata.com/", "snippet": "Crustdata provides high-quality B2B data and APIs for companies", "position": 1 }, { "title": "Crustdata Documentation", "url": "https://docs.crustdata.com/", "snippet": "Complete documentation for Crustdata APIs and services", "position": 2 } ], "metadata": { "totalResults": 9 } }

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-api-version
enum<string>
required

API version to use for request routing and response shape.

Available options:
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"

​
geolocation
string | null

ISO 3166-1 alpha-2 country code for geolocation 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 GitHub profiles.

Maximum string length: 500
Example:

"example.com"

​
startDate
integer | null

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

Example:

1728259200

​
endDate
integer | null

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

Example:

1730937600

​
solveCloudflare
boolean
default:false

Whether to attempt bypassing Cloudflare protection on result pages.

Example:

false

​
numPages
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:
[
  {
    "title": "Crustdata - B2B Data Platform",
    "url": "https://www.crustdata.com/",
    "snippet": "Crustdata provides high-quality B2B data and APIs for companies",
    "position": 1
  }
]
​
metadata
object
required

Metadata about the search results.