Skip to main content
GET
https://api.crawleo.dev
/
google-search
Google Search API
curl --request GET \
  --url https://api.crawleo.dev/google-search \
  --header 'x-api-key: <x-api-key>'
{
  "parameters": {},
  "google_search_results": [
    {
      "title": "<string>",
      "link": "<string>",
      "snippet": "<string>",
      "position": 123
    }
  ],
  "knowledgeGraph": {
    "title": "<string>",
    "type": "<string>",
    "description": "<string>",
    "attributes": {}
  },
  "peopleAlsoAsk": [
    {}
  ],
  "relatedSearches": [
    {}
  ],
  "answerBox": {}
}

​
Overview

The Google Search API delivers real-time Google search results powered by Serper. Get structured SERP data including organic results, knowledge graphs, People Also Ask, news, images, shopping, and more.
Which Search API should I use? Use the Bing Search API for LLM and RAG pipelines (with auto-crawling and content extraction). Use the Google Search API for SEO monitoring, lead generation, competitor research, and structured SERP analysis.

​
Endpoint

GET https://api.crawleo.dev/google-search
Cost: 10 credits per request

​
Parameters

​
Required Headers

​
x-api-key
string
required
Your Crawleo API key for authentication. (Alternatively, use the Authorization: Bearer YOUR_API_KEY header.)Example: x-api-key: YOUR_API_KEY or Authorization: Bearer YOUR_API_KEY

​
Required Parameters

​
q
string
required
The search query.

​
Optional Parameters

​
gl
string
default:"us"
Country for search results. ISO 3166-1 alpha-2 code (e.g. us, gb, eg, de, fr).
​
hl
string
default:"en"
Language for results. IETF language tag (e.g. en, ar, fr, de).
​
tbs
string
Time-based filter for results freshness.
ValueMeaning
qdr:hPast hour
qdr:dPast day
qdr:wPast week
qdr:mPast month
qdr:yPast year
​
page
integer
default:"1"
Page number of results (1-indexed).
​
num
integer
default:"10"
Number of results per page (1–100).
​
type
string
default:"search"
Search type. Controls which vertical of Google results to query.
ValueDescription
searchStandard web search
newsGoogle News results
imagesGoogle Images
placesGoogle Maps / local business results
shoppingGoogle Shopping product listings

​
Example Requests

curl -G "https://api.crawleo.dev/google-search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=best CRM software" \
  -d "gl=us" \
  -d "hl=en" \
  -d "num=10"

curl -G "https://api.crawleo.dev/google-search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=artificial intelligence" \
  -d "type=news" \
  -d "tbs=qdr:d" \
  -d "num=10"

curl -G "https://api.crawleo.dev/google-search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=coffee shops" \
  -d "type=places" \
  -d "gl=gb"

curl -G "https://api.crawleo.dev/google-search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=wireless headphones" \
  -d "type=shopping" \
  -d "num=20"

​
Response

A successful response returns structured SERP data: 
{
  "parameters": {
    "q": "best CRM software",
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  },
  "google_search_results": [
    {
      "title": "Result Title",
      "link": "https://example.com",
      "snippet": "Description of the result...",
      "position": 1
    }
  ],
  "knowledgeGraph": {
    "title": "Entity Name",
    "type": "Category",
    "description": "...",
    "attributes": {}
  },
  "peopleAlsoAsk": [
    {
      "question": "Related question?",
      "snippet": "Answer snippet...",
      "link": "https://example.com"
    }
  ],
  "relatedSearches": [
    { "query": "related query" }
  ],
  "answerBox": {
    "answer": "Direct answer text",
    "snippet": "..."
  }
}
​
parameters
object
Echo of the query parameters used for this request.
​
google_search_results
array
Array of organic search result objects.
​
knowledgeGraph
object
Google Knowledge Graph data (when available).
​
peopleAlsoAsk
array
“People Also Ask” questions and answers (when available).
​
relatedSearches
array
Related search query suggestions (when available).
​
answerBox
object
Direct answer box content (when available).
knowledgeGraph, peopleAlsoAsk, relatedSearches, answerBox, and other enriched fields are only present when Google returns them for the query.

​
MCP Integration

The Google Search API is available as an MCP tool named google_search. It works with your existing Crawleo MCP configuration — no extra setup needed. Tool name: google_search Inputs: Same parameters as the HTTP API (q, gl, hl, tbs, page, num, type)

MCP Setup

Already configured Crawleo MCP? The google_search tool is automatically available.

​
Error Responses

Status CodeDescription
400Missing required parameter q
401Invalid or missing API key
402Insufficient credits
429Rate limit exceeded
500Internal server error

​
Use Cases

Track keyword rankings, featured snippets, and People Also Ask blocks for your target queries. Compare positions over time using the tbs time filter.
Use type=places to surface local businesses in a target region. Combine with gl to geo-target specific markets and extract business names, addresses, and URLs.
Search for competitor brand names or product categories to see what SERP features they own — knowledge graphs, answer boxes, shopping results.
Use type=news with tbs=qdr:d to get today’s news coverage for any topic, brand, or keyword. Ideal for PR monitoring pipelines.
Use type=shopping to fetch product listings, prices, and merchant names across Google Shopping results.
Feed real-time search results into LLMs via MCP to ground responses with current information. The google_search MCP tool is drop-in compatible with Claude, Cursor, and GitHub Copilot.
Retrieve peopleAlsoAsk data to discover content gaps, FAQ opportunities, and audience questions at scale.
Last modified on April 21, 2026