ChangelogNew

Now supporting Google AI Overviews

Google AI Overviews
A Google AI Overview on wireless earbuds next to its JSON result

Send a search query and receive the Google AI Overview with its cited pages, together with the organic results, People Also Ask and related searches from the same page.

What you get

  • aioverview.text and aioverview.sources: the AI Overview and the pages it cites.
  • organicResults: the regular results on the same page, with position, title, link and snippet.
  • peopleAlsoAsk, relatedSearches, knowledgeGraph and ads whenever Google shows them.

How it works

Each task runs your query on Google from the country you set and reads the whole results page. Google decides per search whether to show an AI Overview, and every completed result records whether one appeared: aioverview holds it, or is null for a page with organic results alone.

That record turns into a metric. Across a keyword set, the share of queries with an overview is your AI Overview coverage, and the overviews themselves show which brands and pages Google puts first.

Where it helps

  • Measure how many of your target keywords trigger an AI Overview, market by market.
  • See whether your pages are cited in the overview or rank in the organic results below it.
  • Mine People Also Ask and related searches for new prompts to track.

Send a request

Send the request with your API key in the Authorization header.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GOOGLE",
    "payload": {
      "query": "best wireless earbuds for commuting",
      "country": "US"
    }
  }'

Request fields

taskTypestringRequired
The engine to run, such as CHATGPT or GOOGLE.
payload.querystringRequired
The search query, written the way a user types it into the search box.
payload.countrystring
Two-letter country code of the market to ask from, such as US, KR or JP. Default US.
payload.include.markdownboolean
true adds aioverview.markdown: the overview with its headings, lists and tables, laid out as Google shows it.
webhook.urlstring
An HTTPS address on your server. The finished task is posted there the moment it completes.
idempotencyKeystring
Your own ID for the request. Each key creates one task per account, so a retried send stays a single task.

Response

A finished task looks like this, trimmed for length.

JSON
{
  "success": true,
  "task": {
    "id": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING, then COMPLETED with the answer or FAILED with error.
credits.creditsChargedinteger
Credits charged for the finished task. A failed task charges 0.
response.aioverviewobject
The AI Overview with its text, sources and, on request, markdown. null marks a query that Google answers with search results alone.
response.aioverview.shoppingCardsarray
Product cards shown in the overview: title, price, store, rating, reviews and product link.
response.organicResultsarray
The search results on the page: position, title, link, snippet and page.
response.peopleAlsoAskarray
The related questions Google lists on the page.
response.relatedSearchesarray
The related searches at the foot of the page.

Receive the result

The request returns the task right away with status QUEUED. Poll GET /v1/async/task/{id} until status is COMPLETED or FAILED, or add webhook.url and the finished task arrives at your server with the same task, credits and response. Results stay available for 24 hours after a task finishes.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Pricing

Each completed task uses 2 credits.

More updates

Stay in the loop

Get new product updates in your inbox.

RSS feed