Google Search
Organic results, the local pack, People Also Ask and related searches for one Google results page. Use type=news or type=images for those tabs.
GET /api/v1/searchCost: 1 per request (0 if cached)Example request
curl -G "https://goddsapi.com/api/v1/search" \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "q=coffee shop" \ --data-urlencode "location=Chicago, Illinois, United States" \ --data-urlencode "gl=us" \ --data-urlencode "hl=en"
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
qrequired | string | — | Search query, up to 500 characters. |
location | string | — | Where the search comes from, e.g. "Chicago, Illinois, United States". Omit for a country-level search. |
gl | string | — | Country code, e.g. us, gb, mx. |
hl | string | — | Interface language, e.g. en, es. |
device | desktop | mobile | desktop | Device to emulate. |
num | integer 1–10 | 10 | Organic results to return. Google now serves at most 10 per page — use page for more. |
page | integer 1–10 | 1 | Results page. Each page is a separate request. |
type | web | news | images | web | Which Google tab to search. news → news_results, images → images_results. |
api_key | string | — | Your key, if you can't send the Authorization: Bearer header. Never logged. |
no_cache | boolean | false | true forces a fresh search (charged). Otherwise identical queries within your plan's cache window are served free. |
Example response
Shortened to one item per list.
{
"search_metadata": {
"id": "srch_3f9c0d7b2a41e6c8d5b19a70",
"status": "success",
"api_version": "v1",
"endpoint": "search",
"provider": "serpapi",
"cached": false,
"credits_charged": 1,
"time_taken_ms": 1840,
"created_at": "2026-11-20T15:04:05.000Z"
},
"search_parameters": {
"endpoint": "search",
"q": "coffee shop",
"location": "Chicago, Illinois, United States",
"gl": "us",
"hl": "en",
"device": "desktop",
"num": 10,
"page": 1,
"type": "web"
},
"total_results": 412000000,
"organic_results": [
{
"position": 1,
"title": "The 10 Best Coffee Shops in Chicago",
"link": "https://www.example.com/chicago/coffee",
"domain": "example.com",
"displayed_link": "https://www.example.com › chicago › coffee",
"snippet": "From cozy corner cafes to roasters…",
"date": null,
"sitelinks": []
}
],
"local_pack": [
{
"position": 1,
"name": "Example Roasters",
"place_id": "10140420633749198317",
"rating": 4.7,
"review_count": 1284,
"address": "1137 W Example Ave, Chicago, IL 60614",
"phone": "(312) 555-0142",
"website": "https://example-roasters.com/",
"category": "Coffee shop",
"latitude": 41.9214,
"longitude": -87.6573
}
],
"people_also_ask": [
{
"question": "What is the most famous coffee in Chicago?",
"snippet": "…",
"title": "Example guide",
"link": "https://www.example.com/guide"
}
],
"related_searches": [
{
"query": "coffee shop near me"
},
{
"query": "best coffee shop chicago"
}
]
}- Ads are not part of search responses — search providers rarely return them reliably. Use /api/v1/ads for an advertiser's ads.
- Every array is always present (possibly empty), and every field is always present (null when Google didn't show it), so you never need to check for missing keys.