Google SERP API: Get Structured Search Results with One Request
The first step for many needs is actually to "search": conducting industry research, monitoring keyword rankings, providing real-time information to AI Agents, batch verifying information... But directly scraping Google is both troublesome and unstable—dealing with anti-scraping measures, CAPTCHAs, and changes in page structure.
The Google SERP API simplifies this process: you send a keyword, and it returns structured JSON—natural results, knowledge graphs, related questions, and related searches are all categorized and ready to use. This article explains how to use this interface on Ace Data Cloud. The address is POST https://api.acedata.cloud/serp/google, and the documentation is at platform.acedata.cloud/documents/serp-google. You can get a Token from the console to use it, with a free quota for the first time.
¶ Basic Usage
The simplest usage is to pass query:
curl -X POST 'https://api.acedata.cloud/serp/google' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"type": "search",
"query": "nano banana image model",
"country": "US",
"language": "en",
"number": 5
}'
Below is the actual response of natural results from this request (excerpt, cost is also a real record—this time it is 0.0092 credit):
{
"organic": [
{"position": 1, "title": "Nano Banana 2 - Gemini AI image generator & photo editor", "link": "https://gemini.google/overview/image-generation/"},
{"position": 2, "title": "Nano Banana | Google AI Studio", "link": "https://aistudio.google.com/models/nano-banana"},
{"position": 3, "title": "Nano Banana: Free Online AI Image Editor", "link": "https://nanobanana.io/"},
{"position": 4, "title": "Gemini Image – Nano Banana - Google DeepMind", "link": "https://deepmind.google/models/gemini-image/"},
{"position": 5, "title": "Nano Banana image generation - Interactions API", "link": "https://ai.google.dev/gemini-api/docs/image-generation"}
],
"people_also_ask": [ ... ],
"related_searches": [ ... ],
"cost": {"amount": 0.0092, "currency": "credit", "list_amount": 0.01}
}
The response is returned synchronously, no polling is needed. Each result includes position (ranking), title, link, and snippet, with some also including sitelinks.
¶ Key Fields
Commonly used on the request side:
type: Type of search resource, default issearch; the platform also supports six other types such as images, news, etc., just change thetypeto search for images or news;query: Keyword (required);country/language: The country and language of the results, default is US / en—change these two when checking rankings in different markets;range: Time range (for example, to only see results from the past week);number/page: Number of items per page and page number.
On the response side, besides organic (natural results), common fields include:
knowledge_graph: Entity cards (official website, introduction, key attributes of companies/people), very useful when checking brands or individuals;people_also_ask: Related questions, a ready source of long-tail keywords when selecting content topics;related_searches: Related search terms.
¶ What You Can Do with It
- Keyword Ranking Monitoring: Regularly check the same batch of keywords, record the
positionof each domain, and track SEO rankings; - Provide Real-time Information to AI Agents: Large models have a cutoff date for knowledge; integrating SERP results into the context allows them to answer based on "current real search results," a common part of building RAG / online Q&A;
- Content Topic Selection: Use
people_also_askandrelated_searchesto find out what users are really asking, selecting topics without guessing; - Competitor and Public Opinion Monitoring: Change
typeto news and regularly monitor the latest reports on a specific keyword.
Since the return is clean JSON, you don't need to parse HTML for these tasks; just write a few lines of code to run it as a scheduled task.
¶ Additional Revenue Insights
Infrastructure-type APIs like SERP are easiest to turn into resalable services: a ranking monitoring dashboard, a content topic assistant, a connected search tool for others' Agents—underlying all of these is just this one interface, and your cost is based on the per-query billing (for example, this time it was 0.0092 credit). Distributing tools or registration links and earning commissions through the Ace Data Cloud Revenue Alliance from users you registered is an additional income stream.
¶ Reference Links
- Documentation: https://platform.acedata.cloud/documents/serp-google
- API:
POST https://api.acedata.cloud/serp/google - Get Token: https://platform.acedata.cloud/console/applications
Start by using the free quota to check a keyword you care about, see the returned structure, and then decide how to integrate it into your tool.
