Docs
Search

Perform web search with advanced operators

POST/search
AuthorizationBearer <token>

Enter your API key with the bc_ prefix

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Search query

limit?number

Maximum number of results

Range1 <= value <= 10
Default10
sources?array<string>

Source types to search

Default

[  "web"]
categories?array<string>

Category filters

location?string

Location for geo-targeting

country?string

Country code

Default"US"
tbs?string

Time-based filter (e.g., qdr:d for past day)

timeout?number

Timeout for search operation in milliseconds

Range1000 <= value <= 300000
Default60000

Response Body

application/json

curl -X POST "https://example.com/search" \  -H "Content-Type: application/json" \  -d '{    "query": "machine learning tutorials"  }'
{  "success": true,  "query": "machine learning",  "total": 10,  "creditsUsed": 2,  "data": [    {      "title": "Machine Learning Tutorial",      "url": "https://example.com/ml-tutorial",      "snippet": "Learn machine learning basics...",      "source": "web"    }  ]}
Empty