Sign in

v1

latestOpenAPI 3.0.32026-07-222085264.6 KB
Web APIs

Web Search

Perform a web search query and return results from multiple sources including web, news, academic articles, academic author profiles, deep research results, and social media. Use this endpoint for competitive intelligence, market research, lead generation, and content discovery.

<Note> Default `rate-limit` is 10 requests per minute. Send an email to [gtm@crustdata.co](mailto:gtm@crustdata.co) to discuss higher limits if needed for your use case. </Note>
post/web/search/live

Headers

x-api-version'2025-11-01' required
Example:2025-11-01

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

Request body

querystring required

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

locationstring nullable

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.

sourcesstring[] nullable

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

sitestring nullable

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.

start_dateinteger nullable

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

end_dateinteger nullable

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

human_modeboolean

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

pageinteger

Number of search result pages to return.

Example request

{
  "query": "crustdata",
  "location": "US",
  "sources": [
    "news",
    "web"
  ],
  "site": "example.com",
  "start_date": 1728259200,
  "end_date": 1730937600,
  "page": 1
}

Response

Successful search response with results.

successboolean required

Whether the search was executed successfully.

querystring required

The original search query that was submitted.

timestampinteger required

Unix timestamp in milliseconds when the search was performed.

Example response

{
  "success": true,
  "query": "crustdata",
  "timestamp": 1762908151599,
  "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.",
      "position": 1
    }
  ],
  "metadata": {
    "total_results": 7,
    "failed_pages": [],
    "empty_pages": []
  }
}