Skip to main content
POST
https://api.crustdata.com
/
dataset
/
web
/
search
curl --request POST \
  --url https://api.crustdata.com/dataset/web/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "query": "crustdata"
}
'
{
  "success": true,
  "query": "crustdata",
  "timestamp": 1774446515699,
  "results": [
    {
      "source": "web",
      "title": "Crustdata: Real-Time B2B Data Broker via API or Data Feed",
      "url": "https://crustdata.com/",
      "snippet": "People and Company Search for AI. The only platform providing truly real-time data.",
      "position": 1
    },
    {
      "source": "web",
      "title": "Crustdata - Crunchbase Company Profile & Funding",
      "url": "https://www.crunchbase.com/organization/crustdata",
      "snippet": "Crustdata builds a robust and easy-to-use set of APIs that solves the problem of getting accurate, fresh data on companies and people.",
      "position": 2
    },
    {
      "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": 3
    }
  ],
  "metadata": {
    "totalResults": 7,
    "failedPages": [],
    "emptyPages": []
  }
}

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

The search query and optional filters.

Request payload for /dataset/web/search. Requires a search query and supports optional geolocation, source, site, date range, and pagination filters.

​
query
string
required

The search query text. Supports natural language queries and keywords.

Required string length: 1 - 5000
Example:

"crustdata"

​
geolocation
string | null

ISO 3166-1 alpha-2 country code to localize search results (e.g., "US", "GB", "JP", "IN").

Example:

"US"

​
sources
enum<string>[] | null

List of search sources to query. When omitted, defaults to all available sources.

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 domain (e.g., "linkedin.com" to only return LinkedIn results).

Maximum string length: 500
Example:

"linkedin.com"

​
startDate
integer | null

Unix timestamp (seconds) for the start of the date range filter. Only results published after this date are returned.

Example:

1704067200

​
endDate
integer | null

Unix timestamp (seconds) for the end of the date range filter. Only results published before this date are returned.

Example:

1735689600

​
solveCloudflare
boolean
default:false

Whether to attempt bypassing Cloudflare protection on result pages. Increases latency when enabled.

Example:

false

​
numPages
integer
default:1

Number of search result pages to return. Each page contains approximately 10 results.

Required range: x >= 1
Example:

1

Response

Successfully retrieved search results.

Response payload for /dataset/web/search. Contains the search results, query metadata, and result count.

​
success
boolean
required

Whether the search request completed 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:

1774446515699

​
results
object[]
required

Array of search results ordered by relevance.

Example:
[
  {
    "source": "web",
    "title": "Crustdata: Real-Time B2B Data Broker via API or Data Feed",
    "url": "https://crustdata.com/",
    "snippet": "People and Company Search for AI. The only platform providing truly real-time data.",
    "position": 1
  }
]
​
metadata
object
required

Metadata about the search results.

Example:
{
  "totalResults": 7,
  "failedPages": [],
  "emptyPages": []
}