Google Scraper APIsAutocomplete API
Autocomplete API

Google Autocomplete API for Search Suggestions and Keyword Discovery

Retrieve Google autocomplete predictions for any query, including suggested phrases and relevance scores, through one country- and language-aware search suggestion API.

1,000 free credits
No credit card required

Use the same API key and credit balance across every ScrapeBadger API.

GET /v1/google/autocomplete
{
  "query": "python",
  "suggestions": [
    {
      "value": "python tutorial",
      "relevance": 850
    },
    {
      "value": "python download",
      "relevance": 790
    }
  ],
  "language": "en",
  "country": "us"
}
Endpoints

Explore the Google Autocomplete API Endpoint

Send a search query or partial phrase and receive Google's autocomplete predictions for the selected country and language.

  1. Enter a query
  2. Choose a country and language
  3. Receive suggestions with relevance scores
GET/v1/google/autocomplete7 credits

Google Search Suggestions

Submit a search query or partial phrase and receive Google autocomplete predictions in structured JSON. Each suggestion contains its proposed query value and a numerical relevance score.

Parameters
qrequiredSearch query or partial phrase for which suggestions should be returned.
hloptionalLanguage code. Defaults to en.
gloptionalCountry code. Defaults to us.
Request
curl --get \
  'https://scrapebadger.com/v1/google/autocomplete' \
  --data-urlencode 'q=python' \
  --data-urlencode 'hl=en' \
  --data-urlencode 'gl=us' \
  --header 'x-api-key: YOUR_API_KEY'
Response200 OK
{
  "query": "python",
  "suggestions": [
    {
      "value": "python tutorial",
      "relevance": 850
    },
    {
      "value": "python download",
      "relevance": 790
    },
    {
      "value": "python course",
      "relevance": 720
    },
    {
      "value": "python interview questions",
      "relevance": 680
    }
  ],
  "language": "en",
  "country": "us"
}
View Google Search Suggestions documentation

What Can You Build With the Google Autocomplete API?

Long-tail keyword discovery

Start with a broad keyword and collect the more specific queries Google suggests. Repeat the process with relevant suggestions to expand a keyword list around products, services, questions, or topics.

valuerelevance

Content and topic research

Use question words and search modifiers to find more specific ways users search around a subject. Organise the returned suggestions into potential articles, landing pages, help content, or topic clusters.

howwhatwhybestnear me

Search-as-you-type experiences

Use the API as a search suggestion API inside an application, research tool, or internal dashboard. Display relevant query predictions without building and maintaining a separate prediction model.

qhlgl

Brand and product-query research

Submit brand, product, or category phrases to examine the autocomplete predictions Google currently associates with them. Compare results between countries and languages when researching different markets.

valuecountrylanguage
Sign Up For Free

1,000 free credits · No credit card required

More Google Search Data APIs

Use the same ScrapeBadger account, API key, and credit balance to validate autocomplete suggestions with search results, demand trends, organic listings, and AI-generated answers.

Why Choose ScrapeBadger?

Build Faster

Structured JSON responses remove browser automation, proxy orchestration, and HTML parsing from your roadmap. Make your first request in minutes and move from proof of concept to production without maintaining scrapers.

Scale Confidently

99.9% uptime SLA. Your data pipeline does not stop because Google changes a page, rotates an anti-bot challenge, or moves a result block. Monitoring, session management, browser infrastructure, and parsing are all us.

All Google Data on One Platform

Search, Maps, News, Hotels, Trends, Jobs, Shopping, Patents, Scholar, Images, Videos, Finance, AI Mode, Lens, Local, Shorts, Flights, Products, and Autocomplete — every Google surface under one API key.

Integrate Anywhere

RESTful API, SDK support, MCP, CLI, and no-code options. Use ScrapeBadger in an existing system or a new application with consistent authentication, structured JSON, and unified billing.

Integrate With Your Stack

Use ScrapeBadger through an official SDK, a standard API request, MCP, CLI, or the tools already in your workflow.

Python SDK

Build asynchronous data pipelines with typed responses, retry handling, and access to the complete Google API suite.

Node.js SDK

Add Google data to Node.js and TypeScript applications with type definitions and support for both ESM and CommonJS.

REST API

Connect from any backend or programming language using standard HTTP requests. Responses arrive as structured JSON that can be stored, transformed, or passed into another service.

One API Key

Access Search, Maps, News, Trends, Shopping, Scholar, Flights, and every other supported Google product with one ScrapeBadger API key and one credit balance.

MCP for AI Tools

Give compatible AI agents access to Google Search, Maps, News, Trends, Shopping, Scholar, Images, Flights, and more through ScrapeBadger's MCP server.

ScrapeBadger CLI

Run Google searches, inspect trends, collect local business data, and export results as JSON, CSV, Markdown, or terminal-friendly tables without building an application.

Trusted by Developers Worldwide

See why developers choose ScrapeBadger for reliable, structured web data.

We switched from the official Twitter API and cut our costs by 95%. The pagination is seamless, and we've never hit a rate limit. Best decision we made this year.

MC
Marcus Chen
Lead Data Engineer at DataFlow Analytics
2 weeks ago

The follower and engagement endpoints are incredibly detailed. We use it for influencer research and competitor analysis. Response times are sub-100ms consistently.

SM
Sarah Mitchell
Marketing Director at SocialPulse Agency
1 month ago

Started with the Apify actor, then moved to the API for more control. The 1,000 free credits were enough to build our MVP. Now processing 2M+ tweets monthly.

JR
James Rodriguez
Founder at TweetMetrics
3 weeks ago

Perfect for academic research. The community and trends endpoints give us data we couldn't get anywhere else. Documentation could use more examples, but support is responsive.

EW
Emily Watson
Research Scientist at Stanford NLP Lab
1 month ago

We monitor 50,000+ accounts for our clients. ScrapeBadger handles it without breaking a sweat. The bulk ID endpoints are a game-changer for large-scale monitoring.

AP
Alex Petrov
CTO at MediaMonitor Pro
2 weeks ago

The geo and trends endpoints power our location-based analytics. Setup took 10 minutes. Their Apify actors are also great for quick one-off scrapes.

LP
Lisa Park
Product Manager at Trendy AI
3 weeks ago
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. Failed requests never consume credits, and every Google API endpoint is included on every plan.

Not Sure Which Plan Fits Your Needs? Calculate Your Cost and Find the Right Plan.

Choose an endpoint and enter your expected request volume. Google APIs use flat per-request credits, making usage easy to forecast. Failed requests cost 0 credits.

FAQ

Frequently asked questions

Everything you need to know about the Autocomplete API.

What is the Google Autocomplete API?

The Google Autocomplete API returns the query predictions Google provides as a user types a search phrase. ScrapeBadger returns each prediction with its suggested query value and a numerical relevance score in structured JSON.

Are the Google Autocomplete API and Search Suggestion API the same?

Yes. Google Autocomplete API, Google Suggestions API, and Google Search Suggestion API are commonly used names for the same type of service. In ScrapeBadger, they all use GET /v1/google/autocomplete .

What data does the Google Autocomplete API return?

The response contains the submitted query, an array of suggestions, the selected language, and the selected country. Each suggestion object contains value , which is the suggested query, and relevance , which is the numerical relevance score returned with it.

Can I retrieve autocomplete suggestions for different countries and languages?

Yes. Use gl to choose the country and hl to choose the language. The same query can return different suggestions when either setting changes, making the API suitable for multilingual and market-specific research.

Does the relevance score represent keyword search volume?

No. The documentation does not define relevance as monthly search volume, traffic, CPC, or ranking difficulty. Use the score as returned by the endpoint, and combine the suggestions with Google Trends or another keyword-data source when you need demand metrics.

How is the Google Autocomplete API different from the Google Search API?

The Autocomplete API returns predicted query completions for a search phrase. The Google Search API runs a completed query and returns the corresponding results page. Use /v1/google/autocomplete for search suggestions and /v1/google/search for organic results and other SERP features.

Start Building With the Google Autocomplete API

Use 1,000 free credits to retrieve Google search suggestions, discover long-tail keywords, research market-specific queries, and build autocomplete workflows with structured JSON.

No credit card required · Failed requests cost 0 credits

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with Google LLC or any of its subsidiaries or affiliates. Google and related trademarks are the property of their respective owners.