• Services
  • Models & Pricing
  • Documents
  • Support
  • x402
All models
Google

serp

GoogleSearch
Get your API key
Overview
API
Pricing
serp

Convert Google's diverse search results into usable structured data

serp is a Google search results service for application development and information retrieval, not a conversational generative model. It accepts keywords or query statements and returns program-friendly JSON, covering web, image, news, video, place, and map searches. Combined with controls for region, language, time range, and pagination, it is suitable for building research discovery, keyword monitoring, and AI assistant retrieval workflows.

Try this modelView pricing
GoogleModel brand
Search and automationModel type
Search and automationTask capabilities
STANDARD APIs · QUICK SETUP

Bring this model into your workflow

Submit requests to the public API at api.acedata.cloud using the documented parameters, then use the results in your application.

API hostapi.acedata.cloud
API KeyGet your API key ↗

Input parameters and result formats vary by service. Use the public API for this model and follow its guide for generation, task retrieval and editing operations.

Specifications and interface features

Clarify capacity, input/output, and invocation methods before selecting a solution.

Invocation method
POST /serp/google; Bearer Token authentication; JSON requests and responses
Query input
query is required, 1—2048 characters, and cannot consist entirely of whitespace
Search types
search, images, news, maps, places, videos; default: search
Pagination and count
page: 1—100, default 1; number: 1—100, default 10
Retrieval controls
country, language; range supports the past hour, day, week, month, and year
Image filtering
In images mode, image_size can be used, such as large, medium, icon, 2mp, 4mp
Result structure
Categorized lists may include titles, links, summaries, and locations; related questions, answer boxes, and knowledge graphs may be included

The above are the invocation specifications for the serp search endpoint, not the context or output capacity of a generative model; the actual number of results and additional information vary by query.

Core Capabilities

Learn what serp can bring to your work.

Switch search types by task

A single entry point lets you switch between web pages, images, news, videos, places, and maps, without sending every task to standard web search. Use search to look up company information, news to find coverage, and places to discover local businesses, making your input goal better match the result category.

Keep a processable result structure

Search results are returned as JSON, making it easy to extract titles, links, snippets, and ranking positions, then continue with deduplication, display, or storage. Standard search may also return related questions, related searches, and a knowledge graph, helping applications expand query directions instead of receiving only a block of text that is difficult to split.

Combine regional and time conditions

With country, language, and range, you can organize searches around target markets and time windows. For example, set the country and language separately for the same brand, then query information from the past day or week. page and number control pagination and the number of requests, making it easier to collect results according to task scale.

Use Cases

Start with specific tasks to find where the model can be effective.

Keyword and competitor monitoring

Enter brand terms, product terms, or industry keywords, and save the titles, links, and positions from web results to create search records for comparison. When querying regularly, keep regional, language, and pagination conditions consistent to help monitor competitor pages and keyword performance; recording and comparison logic is organized by the application itself.

News lead organization

Use a company name or event topic as the query, select news, and set a time range to organize returned titles, snippets, links, and available dates into a list of coverage leads. Suitable for editorial planning and brand information monitoring; you should still open the original text to verify details rather than treating short snippets as complete reports.

AI assistant information discovery

Have the assistant first turn user questions into queries, then pass search results to a language model for summarization and citation organization. Clients that support MCP can also use categorized search tools through SerpMCP. serp is responsible for discovering information and returning links, while final answers, web reading, and multi-step execution are handled by the assistant workflow.

How to choose this model

Choose based on task complexity, input materials, and expected results.

Choose serp when you need to retrieve materials

If the task requires internet links, search snippets, result positions, or related queries, serp is a better fit than asking a generative model to answer solely from its existing knowledge. If the deliverable is a long-form article, explanation, or comprehensive analysis, you can first use serp to obtain materials and then pass them to a language model for processing; it does not generate articles itself, nor does it automatically read all matched webpages.

Choose by result category, not by generation

The key to choosing serp is the search mode, not version upgrades of generative models. For general information discovery, use search; for recent reporting, use news; for image and video discovery, use images and videos respectively; for local businesses, use places or maps. The direct API is suitable for embedding in programs, while MCP is suitable for invocation by compatible clients; neither represents a different model generation.

Getting started: organize sourced industry information

First prepare the inputs, then connect them to the appropriate application workflow.

Prepare inputs

Prepare clear query terms, choose a web or news type, and set the language, region, and required time range.

Organize calls and subsequent workflows

Choose types such as search, news, or images based on the needed results, save search criteria and pagination first, then add result titles, links, and snippets to the materials list. Before consolidating conclusions, return to key sources to verify the full text.

Practical task example: organize sourced industry information

Design tasks directly from the following inputs and acceptance priorities.

Recommended task

Use /serp/google to search for official product information, retaining the title, link, snippet, and search criteria for each result; record page numbers when paginating.

Key checks

Open key sources one by one and check whether the publication date and full text support the conclusions; search snippets are for discovering materials and cannot replace full-text verification.

Usage Boundaries

Before formal use, understand output quality and capability scope.

  • Search returns result entries and available summaries; it does not equal the full text of target webpages, nor does it equal video transcription or image content analysis. Additional objects such as answer_box and knowledge_graph are not guaranteed to appear every time; programs should allow for missing fields and empty results.
  • number is the requested number of results and cannot be regarded as guaranteeing that the corresponding number will be returned each time. Pagination is also not suitable as a guarantee of complete coverage of internet content; when comparing keyword performance, retain the query conditions and avoid directly mixing results from different regions, languages, or time windows into one group.
  • image_size can only be used with images and indicates an image search filter condition, not an image generation resolution. country and language are used to adjust search preferences; do not assume that every result comes from the specified country or that all body text uses the same language.

Frequently Asked Questions

Answers to common questions when using serp.

Is serp Google's conversational model?

No. serp is a Google search results service that returns structured search data after receiving a query, rather than generating conversations. It is suitable for finding webpages, news, or other resources; when explanations, writing, and integrated judgment are needed, search results can be passed to a language model for further processing.

What is needed for the simplest serp request?

Send a POST request to /serp/google, use a Bearer Token, and provide query in the JSON request body; no model is needed. The default type is search, the page number is 1, and the requested number is 10; the query cannot contain only whitespace characters, and do not add undefined parameters.

How do I search for news from the past day?

Set type to news, fill query with event or brand keywords, and use d or qdr:d for range. When targeting a specific market, country and language can also be set. Returned content is for discovering recent coverage; specific publication times and event details should still be confirmed against the original text.

Can image search specify a generation size?

No, serp searches existing images and does not generate new images. When type is images, image_size can be used to set large, medium, icon, or supported mp filter tiers; other search types cannot carry this field. Image links in the results also do not mean that permission for use has been obtained.

Will webpages open automatically after getting search results?

A single search request will not automatically complete webpage reading or multi-step research. serp returns links, summaries, and available additional information, which applications can use to choose what to read next. When used through MCP, search is only one tool available to the assistant; the complete task is still organized and executed by the client.

  • Platform API Documentation

Use it in your favorite tools

Choose a development approach or application suited to this model and follow its setup guide.

↗

Python SDK Integration Guide

SDK installation, authentication and examples
↗

TypeScript SDK Integration Guide

SDK installation, authentication and examples
↗

Claude Code with Google Search MCP

Service MCP setup · model options depend on the current tool list
↗

Claude App with Google Search MCP

Service MCP setup · model options depend on the current tool list
↗

Google SERP API

API parameters and request examples
Browse all application guides ↗

Contact Us

辰汐ai

Resources

Services

Developer Documentation

Links

Referral Earnings

Support

Terms of Service

Privacy Policy

辰汐ai © 2026 Copyright

All third-party product names, logos, and brands are the property of their respective owners and are used for identification purposes only. Their use does not imply any affiliation with or endorsement by them.