Track Google Search results

POST https://api.answerline.dev/v1/monitor/google

Get structured output from Google Search: organic listings, related searches, People Also Ask and, optionally, the AI Overview

From $1.00 per 1,000 Failed requests are free Async task type GOOGLE Google Search fields and prices

Body

query string

Query to run on Google. Mandatory when 'url' is not given; send one or the other, never both.

url string

A full URL of a Google web search, executed as-is in place of a request assembled from 'query' plus the targeting fields. It has to be absolute and http(s), hosted on one of Google's web search domains (google.com, google.co.uk, www.google.de, ...), with '/search' as its path and a 'q' that is not empty. Cannot be combined with 'query', 'location', 'uule' or 'pages', since the URL already determines them. It may carry only these query parameters, which are kept: 'q', 'gl', 'num' (treated as result depth), 'hl' and 'uule'; a URL with any other (such as 'start', 'tbs' or 'safe') is refused with a 400. Without 'uule', the search is localized to the requested country. A URL containing 'tbm' is refused: it points at a Google vertical that has a separate endpoint and price (for tbm=nws, call POST /v1/monitor/google/news).

country string

Country for localized search results, as an ISO 3166-1 alpha-2 code. Mandatory in the standard request form. If you send 'url' instead, the country is taken from the URL's 'gl' parameter; set it yourself to override that value, or when the URL carries no 'gl'.

gl string

Google's own name for the result-geography parameter, usable in place of country. Takes ISO 3166-1 alpha-2 codes, as country does, in upper or lower case (us or US), and the country has to be one this endpoint supports (list them with GET /v1/countries; Google News has no model value there, and its edition countries are listed at https://answerline.dev/docs/coverage#countries). Send either country or gl; if both are sent with differing values, the request fails with 400.

state string

US state code (e.g. "CA", "DC" included). Sent without a country, the request asks for the US; sent with any country other than "US", it is refused with a 400, uncharged. ChatGPT and Gemini answer as a person in that state sees it; every other engine accepts it and answers for the whole US, at the price of a request without it. provenance.requestedState reports the state asked. See https://answerline.dev/docs/coverage#states

hl string

Interface language, in the format of Google's hl parameter (for example en, de, pt-BR). Case-insensitive free text; Google defines which codes exist. Takes precedence over the language Answerline infers from the country, which lets interface language and result geography differ.

location string

Location name in Google's canonical comma-separated form 'City,Region,Country' (roughly 100,000 accepted locations are listed at https://developers.google.com/google-ads/api/reference/data/geotargets). Combine with 'country' to target a specific city. Cannot be sent together with 'uule'; choose one of the two. Not allowed when 'url' is set.

uule string

A ready-made Google UULE string for exact geo-targeting, in the location-name form (starting w+CAIQICI); the coordinate form (a+) is refused with a 400. Supply it when you already have an encoded UULE rather than a location name. Cannot be sent together with 'location'; pass only one of the two. Not allowed together with 'url'; in that case add 'uule' to the URL's query string.

device "desktop" | "mobile" | "ios" | "android"

Device to run the search on. 'desktop' gives the desktop SERP, while 'ios' (Safari on an iPhone), 'android' (Chrome on an Android phone) and 'mobile' (same as 'android') each give the mobile SERP.

pages integer

How many pages of search results to retrieve (1-10). Not allowed together with 'url': when 'url' is given, depth is taken from the URL's 'num' parameter (rounded up to full 10-result pages, at most 10 pages).

include object

Flags that add extra data to the response (optional)

6 properties

include.html boolean: A copy of each Google results page as it was when the answer was captured, stored on our file host and linked in html, to check the answer against. No extra cost.
include.aioverview object: Add Google's AI Overview to the response
include.paaAioverview boolean: Fill People Also Ask items of the AI Overview type with markdown content and their sources. Free: only include.aioverview is billed, as the AI Overview add-on. Every hydrated item needs one more fetch (usually 1-2 on a page), which makes responses slower.
include.googleGoto boolean: Has had no effect since 8th September 2026. Each redirect link is now always returned as redirectLink next to its target, so you get both without setting this flag. Requests that still include it are handled as though it were omitted.
include.rawWire boolean: Return the engine's own response as received in result.rawWire: the answer stream, the rendered results pages or the RSS feed, without Gemini's detected location or ChatGPT's session tokens; null where it was not captured. Free. See https://answerline.dev/docs/output-formats#raw-wire
include.screenshot boolean: Return a full-page PNG screenshot of the engine's page as it showed the finished answer, in result.screenshot: a link, or one link per results page on Google Search. On ChatGPT, Gemini, AI Mode, Google Search, Perplexity and Grok; other engines refuse it with a 400. Absent when the answer was read without a rendered page or its page was not available. Free. See https://answerline.dev/docs/output-formats#screenshots

answerDepth "any" | "full" | "quick"

Accepted so existing requests stay valid; it does not change the answer or the price. Every engine writes one depth: Perplexity answers every request with its Quick Search answer, and provenance.answerDepth says quick. See https://answerline.dev/docs/engine-features/#answer-depth

Returns

result.organicResults object[]

Google organic results

result.peopleAlsoAsk object[]

Google's "People also ask" questions

result.peopleAreSaying object[]

Items from the Google results module titled "What people are saying" or "Trending posts and discussions". When the page has no such module, result leaves this field out instead of returning an empty array, so treat it as optional.

result.localResults object[]

Businesses in Google's local pack (the map-based "3-pack" of nearby businesses shown for local-intent searches, e.g. "best ramen in seattle"). If the SERP has no local pack, result does not contain this field at all, so treat it as optional instead of relying on an empty array. Applies to desktop only; neither the mobile layout nor the hotels/travel pack (a separate panel) is returned.

result.localResultsMoreLink string

Full URL of the "More places" / "More businesses" control shown under the local pack; it opens Google's larger Local Finder for this query. Present only together with localResults, and only if the SERP shows that control.

result.relatedSearches object[]

Responses

200: Google monitoring result (success)
400: Bad Request - one or more parameters are not valid
401: Unauthorized - API key absent or not valid
403: Forbidden - INSUFFICIENT_CREDITS: the balance does not cover this request
404: Not Found - No such route, or the engine is paused
409: Conflict - the resource is in a conflicting state
429: Too Many Requests - the call could not start now (CONCURRENT_LIMIT_EXCEEDED), or the service dropped the request because it was overloaded (SERVICE_OVERLOADED); that case returns Retry-After without any limit headers. RATE_LIMIT_EXCEEDED, with Retry-After, is sent only when one address presented too many unknown keys
499: Client Closed Request - the client cancelled the request
500: Internal Server Error
502: Bad Gateway - the engine failed

Error codes and retries

Request

curl -X POST "https://api.answerline.dev/v1/monitor/google" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"project management software","country":"US","include":{"aioverview":{"markdown":true}}}'

import { Client } from "@answerline/sdk";

const client = new Client({ apiKey: process.env.API_KEY! });
const answer = await client.monitor.google({
  "query": "project management software",
  "country": "US",
  "include": {
    "aioverview": {
      "markdown": true
    }
  }
});

import os
from answerline import Client

with Client(os.environ["API_KEY"]) as client:
    answer = client.monitor.google(
        query="project management software",
        country="US",
        include={
            "aioverview": {
                "markdown": True
            }
        },
    )

Response

{
  "success": true,
  "result": {
    "organicResults": [
      {
        "position": 1,
        "title": "The Best Monitors for Developers in 2024",
        "link": "https://example.com/best-programming-laptops",
        "source": "Serious Eats",
        "displayedLink": "https://example.com",
        "snippet": "Shopping for a tablet to draw on? We compared and ranked the leading models...",
        "date": "2 days ago",
        "rating": 4.7,
        "ratingMax": 5,
        "reviews": 14,
        "price": {
          "value": 169.99,
          "currency": "$",
          "raw": "$169.99"
        },
        "page": 1,
        "sitelinks": {
          "inline": [
            {
              "title": "Specifications",
              "link": "https://example.com/specs",
              "snippet": "Full specifications and dimensions.",
              "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
            }
          ]
        },
        "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
      }
    ],
    "peopleAlsoAsk": [
      {
        "question": "How much RAM does a coding laptop really need?",
        "type": "AIOVERVIEW",
        "snippet": "The main factors to weigh are screen size, battery life, and stylus support...",
        "title": "Key hardware specs for coding laptops",
        "link": "https://example.com/laptop-specs",
        "markdown": "string",
        "sources": [
          {
            "label": "Coding Notebook Buyer's Notes",
            "url": "https://example.com/guide",
            "description": "string",
            "position": 0,
            "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
          }
        ],
        "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
      }
    ],
    "peopleAreSaying": [
      {
        "position": 1,
        "title": "Top trail shoes of 2026 - runner reviews",
        "link": "https://www.reddit.com/r/running/comments/example/",
        "date": "5 days ago",
        "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
      }
    ],
    "localResults": [
      {
        "position": 1,
        "title": "Corner Slice Midtown",
        "placeId": "/g/11bw4ws2mt",
        "rating": 4.4,
        "reviews": "26K",
        "price": "$10–20",
        "type": "Pizza",
        "yearsInBusiness": "45+ years in business",
        "address": "1435 Broadway",
        "phone": "(212) 555-0100",
        "hours": "Open · Closes 10 PM",
        "description": "\"Friendly staff, a cozy patio, and the best tacos in town.\"",
        "links": {
          "website": "https://villageplumbing.com/",
          "directions": "https://www.google.com/maps/dir//Village+Plumbing,+Air+%26+Electric",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      }
    ],
    "localResultsMoreLink": "https://www.google.com/search?q=italian+restaurants+in+toronto&udm=1",
    "relatedSearches": [
      {
        "query": "cheap laptop for software development",
        "link": "https://google.com/search?q=best+budget+laptop+for+coding"
      }
    ],
    "ads": [
      {
        "position": 1,
        "blockPosition": "top",
        "type": "RESULT",
        "title": "Coding Monitors on Sale - Buy Today",
        "url": "https://example.com/programming-laptops",
        "page": 1,
        "displayedUrl": "example.com/laptops",
        "domain": "example.com",
        "description": "Order ergonomic coding keyboards with free returns.",
        "category": "Sponsored products",
        "price": {
          "value": 1199,
          "currency": "$",
          "raw": "$1,199"
        },
        "oldPrice": {
          "value": 1299,
          "currency": "$",
          "raw": "$1,299"
        },
        "store": "Apple",
        "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:...",
        "sitelinks": [
          {
            "url": "https://example.com/gaming-laptops",
            "title": "Gaming Laptops",
            "description": "Budget monitors for home offices"
          }
        ]
      }
    ],
    "aioverview": null,
    "shoppingCards": [
      {
        "title": "Brooks Women's Ghost 17",
        "position": 1,
        "productLink": "",
        "promoLabel": "20% OFF",
        "category": "More products",
        "price": {
          "value": 169.99,
          "currency": "$",
          "raw": "$169.99"
        },
        "oldPrice": {
          "value": 199.99,
          "currency": "$",
          "raw": "$199.99"
        },
        "store": "Runner's Depot",
        "rating": 4.5,
        "reviews": "384",
        "thumbnail": "https://example.com/product.jpg"
      }
    ],
    "knowledgeGraph": {
      "title": "Eminem",
      "type": "American rapper",
      "kgmid": "/m/01vs_v8",
      "description": "Robyn Rihanna Fenty, known professionally as Rihanna, is a Barbadian singer, businesswoman, and actress.",
      "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:...",
      "website": "https://www.eminem.com",
      "menu": "https://www.restaurant.com/menu",
      "trailer": "https://www.youtube.com/watch?v=example",
      "source": {
        "name": "Wikipedia",
        "link": "https://en.wikipedia.org/wiki/Eminem",
        "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
      },
      "attributes": [
        {
          "key": "Born",
          "value": "March 3, 1968"
        }
      ],
      "profiles": [
        {
          "name": "Instagram",
          "link": "https://www.instagram.com/eminem/",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "peopleAlsoSearchFor": [
        {
          "name": "Jay-Z",
          "link": "https://www.google.com/search?q=Jay-Z",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "thingsToKnow": [
        {
          "label": "Albums",
          "subtitle": "Abbey Road, Revolver, Let It Be, ..."
        }
      ],
      "ratings": [
        {
          "platform": "Rotten Tomatoes",
          "rating": "88%",
          "link": "https://www.rottentomatoes.com/m/8_mile",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "streamingOptions": [
        {
          "platform": "Netflix",
          "link": "https://www.netflix.com/title/example",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "webRatings": [
        {
          "platform": "Google",
          "rating": "4.5",
          "link": "https://www.google.com/maps/place/...",
          "votes": "1,234",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "statsCard": {
        "context": "2024-25 regular season",
        "stats": [
          {
            "label": "Points per game",
            "value": "27.1"
          }
        ]
      },
      "socialPosts": [
        {
          "platform": "X",
          "text": "Tour dates announced tonight 🎤",
          "link": "https://x.com/eminem/status/...",
          "date": "2 days ago",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "notableAlumni": [
        {
          "name": "Barack Obama",
          "link": "https://www.google.com/search?q=Barack+Obama",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "contact": [
        {
          "label": "Order online",
          "url": "https://www.restaurant.com/order",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "weather": {
        "temperature": "72°F",
        "condition": "Sunny"
      },
      "rating": {
        "rating": "4.5",
        "count": "2,847"
      },
      "admission": [
        {
          "provider": "Official website",
          "price": "$17",
          "link": "https://www.louvre.fr/en/tickets",
          "badge": "Best price",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "artworks": [
        {
          "title": "Mona Lisa",
          "link": "https://www.google.com/search?q=Mona+Lisa",
          "author": "Claude Monet",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "has3dModel": true,
      "hotelOptions": [
        {
          "provider": "Booking.com",
          "price": "$189/night",
          "link": "https://www.booking.com/hotel/...",
          "note": "Includes breakfast",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "trendingProducts": [
        {
          "title": "Cloudsurfer 7",
          "price": "$120",
          "link": "https://www.nike.com/t/air-max-90",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "merchantVideos": [
        {
          "title": "Spring Running Shoe Event",
          "link": "https://www.youtube.com/watch?v=...",
          "platform": "YouTube",
          "duration": "2:34",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "listenOn": [
        {
          "platform": "Spotify",
          "link": "https://open.spotify.com/artist/...",
          "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
        }
      ],
      "redirectLink": "https://www.google.com/goto?url=CAESaAHrOzAVev0pi_wnTxm1qpiZTmMyAllabLr1or10ZCfvJKPk"
    },
    "html": [
      "https://files.answerline.dev/html/b83e8dfd-c3a1-4b98-83b9-af91adc21e26/1/page-1.html"
    ],
    "screenshot": [
      "https://files.answerline.dev/html/c45a5081-808d-4ed3-9c86-e4baf16c8ab8/1/3f9a1c2e8b7d4a6f9e0c1b2a3d4e5f60/page-1.png"
    ],
    "recipes": [
      {
        "position": 1,
        "title": "Moist Banana Bread Recipe",
        "link": "https://natashaskitchen.com/banana-bread-recipe-video/",
        "source": "Natasha's Kitchen",
        "ingredients": "Eggs, baking soda, raisins, ripe bananas, all purpose flour",
        "totalTime": "1 hr 10 min",
        "rating": 5,
        "reviews": 7100
      }
    ],
    "videos": [
      {
        "position": 1,
        "url": "https://www.youtube.com/watch?v=example",
        "title": "Top Monitors for Coding 2024",
        "source": "Tech Channel",
        "platform": "YouTube",
        "date": "Oct 18, 2026"
      }
    ],
    "images": [
      {
        "position": 1,
        "title": "Chocolate chip cookies on a cooling rack",
        "link": "https://example.com/cookies",
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQ..."
      }
    ],
    "spelling": {
      "query": "chocolate chip cookie recipe",
      "type": "SHOWING_RESULTS_FOR"
    }
  }
}

{
  "success": false,
  "error": "Request validation failed",
  "details": [
    {
      "field": "prompt",
      "message": "Prompt must not be empty"
    }
  ]
}

{
  "error": {
    "code": "EXTERNAL_SERVICE_ERROR",
    "message": "External service error: the service failed",
    "details": {
      "service": "CHATGPT"
    },
    "timestamp": "2025-01-15T12:00:00.000Z"
  }
}