--- title: "Search" description: "Get one Google results page, with every block in page order." --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/google/search ``` Send parameters as a query string with `GET`, or as a JSON body with `POST`. Both are equivalent. ## Request ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/google/search?q=best+running+shoes&country=US" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ q: "best running shoes", country: "US" }); const res = await fetch(`https://gateway.apinoa.com/v1/google/search?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/google/search", params={"q": "best running shoes", "country": "US"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## Parameters | Parameter | Type | Required | Notes | |---|---|---|---| | `country` | enum | | The market, as an ISO 3166 country code. `US` `GB` `CA` `AU` `DE` `FR` `IT` `AT` `JP` `KR` | | `cursor` | string | | The previous page's `cursor`. Pass it alone for the next page. | | `device` | enum | | Which page to read: the desktop (default) or the mobile one. `desktop` `mobile` | | `image` | string | | An image URL: a reverse-image search instead of `q` (`type=image`). | | `lang` | string | | Interface language. | | `limit` | integer 1–50 | | Results wanted (default 10, at most 50). More than one page is charged per page. | | `q` | string | | The query, search operators included. | | `safe` | enum | | Safe search. `on` `off` | | `timeRange` | enum | | Only results from this past period. `hour` `day` `week` `month` `year` | | `type` | enum | | What to search: web results (default), news, images, videos or `image` for a reverse-image search. `web` `news` `images` `videos` `image` | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## Response Returns [`ResultsPage`](/docs/api-reference/serp/response-schema#resultspage) in `data`. A real response, shortened: arrays keep their first entries and long text is cut. ```json { "success": true, "data": { "engine": "google", "query": "best running shoes", "type": "web", "outcome": "results", "country": "US", "lang": "en", "device": "desktop", "page": 1, "items": [ { "type": "organic", "url": "https://believeintherun.com/shoe-reviews/best-road-running-shoes-of-2025/", "title": "Best Road Running Shoes of 2025 | Best in Gear Awards", "snippet": "Puma is at the top of their game in 2025, New Balance SC Elite v5 $250. Endorphin Elite 2 is the best Saucony…", "site": "Believe in the Run", "displayUrl": "https://believeintherun.com › shoe-reviews › best-road-...", "date": "2025-11-26", "position": 1, "rank": 1, "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSU…" }, { "type": "organic", "url": "https://www.reddit.com/r/runninglifestyle/comments/1kewifs/what_are_some_good_running_shoes/", "title": "What are some good running shoes. : r/runninglifestyle", "snippet": "I’m looking for good running shoes for training the one I got for training hurt my calf when running for long…", "site": "Reddit · r/runninglifestyle", "date": "2025-10-30", "ext": { "meta": "100+ comments · 1 year ago", "answers": "105 answers", "topAnswer": "As a lover of running and also a mailman as a full time job, I run and walk a lot. I think ..." }, "position": 2, "rank": 2, "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSU…" }, { "type": "ad", "block": "bottom", "url": "https://www.vivobarefoot.com/", "title": "Run like nature intended | Barefoot Running Shoes", "snippet": "Vivobarefoot | Barefoot Running Shoes | Minimalist Footwear. Start your barefoot running journey...", "advertiser": "Vivobarefoot", "displayUrl": "https://www.vivobarefoot.com › barefoot › running", "sitelinks": [ { "url": "https://www.google.com/goto?url=CAEScgHrOzAVfvorgfPQaHxGHETTF2n_EjVLthnHv2LBWiwqWRLFkOn8KVE4ujEDC8dcllVsAnzpYB…", "title": "100 Day Trial." }, { "url": "https://www.google.com/aclk?sa=L&ai=DChsSEwiws-DexeCXAxVaWEcBHRwMNWsYACICCAIQBBoCcXU&co=1&ase=2&gclid=EAIaIQob…", "title": "It's time to run slow" } ], "ext": {"notes": ["1M+ visits in past month"]}, "rank": 5, "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSU…" }, { "type": "shopping", "title": "Popular products", "items": [ { "title": "Men's Running Shoes Under Armour Velociti Distance", "price": "$90.28", "originalPrice": "$160", "merchant": "Under Armour", "moreStores": true, "rating": 4.9, "reviews": "53", "badge": "43% OFF", "delivery": "Free delivery", "thumbnail": "data:image/webp;base64,UklGRhgWAABXRUJQV…", "merchantIcon": "data:image/png;base64,iVBORw0KGgoAAAANSU…", "ids": { "cid": "17500536046254188743", "pid": "8929790825032956959", "gid": "18243703563634929685", "iid": "156849108901779669", "oid": "17925735183046230959" } }, { "title": "Nike Men's Structure 26", "price": "$115.99", "originalPrice": "$145", "merchant": "DICK'S Sporting Goods", "moreStores": true, "rating": 4.5, "reviews": "811", "badge": "20% OFF", "thumbnail": "data:image/webp;base64,UklGRmgGAABXRUJQV…", "merchantIcon": "data:image/png;base64,iVBORw0KGgoAAAANSU…", "ids": { "cid": "7761143186705950565", "pid": "9947796076762022400", "gid": "4433750102634774197", "iid": "12620312263696104752", "oid": "10698345940566205523" } } ], "rank": 6 }, { "type": "relatedSearches", "queries": ["Best running shoes 2024", "Best running shoes 2025 men"], "rank": 13 } ], "cursor": "S8w7EMQm4UtS8e0wFEps0p0dftmlh_7Qty-oISXNcMRP5-4x7b847hfRplS84UdBLtmel3vQ5d1CRIDI9xss64bXrUStYrI1VxX1KatMsAD8or…", "fetchedAt": "2026-10-30T01:03:05.291Z" } } ``` ## Errors | Status | Code | Meaning | |---|---|---| | 400 | `INVALID_CURSOR` | The `cursor` is not one this operation returned. Start again without it. | | 400 | `INVALID_PARAMS` | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. | | 401 | `UNAUTHORIZED` | The `x-api-key` header is missing, or the key is revoked or unknown. | | 402 | `INSUFFICIENT_BALANCE` | The balance does not cover this call. Top up in the dashboard. | | 429 | `MARKETPLACE_SATURATED` | Too many concurrent calls. Retry after the `Retry-After` seconds. | | 502 | `UPSTREAM_ERROR` | The engine answered with something unusable. Retry with backoff. | | 503 | `SERVICE_UNAVAILABLE` | A temporary failure. Retry with backoff. | Every code is listed in [Errors](/docs/errors). Failed calls are not billed. ## Pricing **Price** $0.0012 per call, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## Notes - `type=image` with an `image` URL instead of `q` runs a reverse-image search. - When Google shows an AI Overview, it is an `aiOverview` item holding the same [Answer](/docs/api-reference/answers/response-schema#answer) as the AI Answers API. - `limit` above one page reads further pages, one unit each.