Skip to main content
POST
/
search
Introduction to Search API
curl --request POST \
  --url https://api.example.com/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "num_results": 123,
  "depth": {},
  "language": {},
  "country": {},
  "format": {},
  "intent": "<string>",
  "remove_duplicates": true,
  "include_content": true,
  "start_date": "<string>",
  "end_date": "<string>"
}
'
{
  "status": "<string>",
  "duration_seconds": 123,
  "original_query": "<string>",
  "expanded_queries": [
    "<string>"
  ],
  "reranked_all": [
    {
      "link": "<string>",
      "title": "<string>",
      "description": "<string>",
      "global_rank": 123,
      "relevance_score": 123,
      "unlocked_content": "<string>",
      "extensions": [
        {}
      ]
    }
  ]
}

​
Authorization

​
Authorization
string
required
Bearer authentication header in the form Bearer <token>, where <token> is your API key.

*You can get your API key from from here

​
Body Parameters

​
query
string
required
The search query.
​
num_results
integer
The number of results to return. Range: 1 to 100.
​
depth
enum<string>
default:"base"
The depth of search results.

Available options: base , advanced
​
language
enum<string>
default:"en"
The language to search in and return data for.

Available options: en, es, fr, de, zh, ja
​
country
enum<string>
default:"US"
Get search results from a specific country. This will prioritize content from the selected country in the search results.Available options: US, UK, CA, DE, FR, JA, AU
​
format
enum<string>
default:"json"
The response format.Available options: json, markdown
​
intent
string
Query for BrightData to provide the most relevant results. If not provided, the original query will be used as the intent.
​
remove_duplicates
boolean
default:"true"
If true, duplicate results will be removed from the response.
​
include_content
boolean
default:"false"
If true, the response will include the page content in markdown format.
​
start_date
string
Search only for content updated from the date specified (format: YYYY-MM-DD).
​
end_date
string
Search only for content updated until the date specified (format: YYYY-MM-DD).

​
Example

curl "https://serp-api.hola.org/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "query": "artificial intelligence trends 2026",
    "num_results": 20,
    "depth": "advanced",
    "language": "en",
    "country": "US",
    "format": "json",
    "intent": "latest AI technology developments",
    "remove_duplicates": true,
    "include_content": true,
    "start_date": "2025-01-01",
    "end_date": "2025-12-31"
  }'
Response: 
{
  "status": "ok",
  "task_id": <task_id>
}

​
Retrieve Results

curl "https://serp-api.hola.org/get_results?task_id=<task_id>" \
  -H "Authorization: Bearer <token>"

​
Response

​
status
string
The status of the request: processing or done
​
duration_seconds
integer
The time taken to process the request in seconds.
​
original_query
string
The original search query submitted.
​
expanded_queries
string[]
Array of automatically generated query variations used to improve search coverage.
​
reranked_all
object[]
A list of sorted search results.

​
Example Response

{
  "status": "done",
  "duration_seconds": 144,
  "original_query": "artificial intelligence trends 2026",
  "expanded_queries": [
    "artificial intelligence trends 2026 future predictions",
    "artificial intelligence trends 2026 impact on jobs",
    "artificial intelligence trends 2026 ethical considerations",
    "artificial intelligence trends 2026 regulatory changes",
    "artificial intelligence trends 2026 emerging technologies"
  ],
  "reranked_all": [
    {
      "link": "https://www.trigyn.com/insights/ai-trends-2026-new-era-ai-advancements-and-breakthroughs",
      "title": "AI Trends in 2026: Advancements and Breakthroughs Ahead",
      "description": "17 hours ago — Explore top AI trends for 2026, from enterprise adoption to autonomous systems and breakthrough business innovations.",
      "global_rank": 6,
      "relevance_score": 0.9823961,
      "unlocked_content": "# AI Trends in 2026: A New Era of AI Advancements..."
    }
  ]
}