Google Search API

GET | POST /v1/google/search

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl "https://gateway.apinoa.com/v1/google/search?q=best+running+shoes&country=US" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

Parameter	Type	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.

Response

Returns ResultsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "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. 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; 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 as the AI Answers API.
limit above one page reads further pages, one unit each.

Search