创建账户并在 API Keys 获取密钥。通过 X-API-Key 传入，不要放入 URL 或公开代码。遵循各产品的请求方法与参数。HTTP 200 不代表成功，请检查 status 和 error。Playground 请求可能消耗积分。
公共响应结构
每笔请求按接口价格计费；已执行的失败也可能扣费
支持请求追踪编号
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: your_api_key' \
-d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'账号 QPS 自动升档
符合条件的充值确认入账后，按累计 USD 金额自动提升至至少以下 QPS：$3 → 2、$50 → 5、$100 → 10、$200 → 15、$1,000 → 50、$10,000 → 500。未满 $3 保持当前账户限额。只升不降，已有更高限额不会降低；不是无限 QPS。
| 累计符合条件的充值（USD） | 至少提升至（QPS，请求/秒） |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
仅统计已确认入账的 USD 积分包（credit_pack）和自动充值（auto_topup）付款。订阅（包括 Starter Boost）、赠送和礼品码不计入。积分余额不等于累计充值美元金额；非 USD 付款不能未经换汇直接计作 USD。
同一账户的所有 API Key、产品和网关共用一个 QPS 限额；增加 Key 不会增加限额。
符合条件的充值确认入账后自动提升账号 QPS，付款跳转回来不代表已生效。现有限额以账户显示的服务端数值为准，API Key 同步可能短暂延迟。
目录每请求价格与实际扣费字段解读。
每请求按目录固定价格计费，不按返回页数计费。Web Crawl 和 User Agent 当前均为每请求 1 积分；User Agent 并非免费。有来源和资源身份依据的真实不存在结果正常收费。仅有 no_results、HTTP 404 或缺少 hydration/解析数据不能证明不存在。目前已执行的失败可能扣费，并非所有失败都保证退款。credits_charged 表示实际扣费：0 表示报告为零，null 或缺失表示未知。charge_status 为 UNKNOWN 时即使有扣费数值也仍是未知。请核对账户记录并提供 request_id 联系支持，不要假定已退款或盲目重试。
- Google Web Search: 1 积分 / 请求
- Google Images Search: 1 积分 / 请求
- Google News Search: 1 积分 / 请求
- Google Videos Search: 1 积分 / 请求
- Google Maps Search: 2 积分 / 请求
- Google Maps Place Detail: 3 积分 / 请求
- Google Maps Reviews: 2 积分 / 请求
- Google Search Autocomplete: 1 积分 / 请求
- Google Shopping Search: 2 积分 / 请求
- Google Jobs Search: 2 积分 / 请求
- Google Scholar Search: 2 积分 / 请求
- Google Books Search: 1 积分 / 请求
- Google Finance Search: 1 积分 / 请求
- Google Patent Details: 2 积分 / 请求
- Google Play Search: 1 积分 / 请求
- Google Play App Details: 1 积分 / 请求
- Google Trends: 2 积分 / 请求
- Google Trends Autocomplete: 2 积分 / 请求
- Google Trends Trending Now: 2 积分 / 请求
- Bing Web Search: 1 积分 / 请求
- DuckDuckGo Search: 1 积分 / 请求
- Reddit Post & Comments: 2 积分 / 请求
- Reddit Search: 1 积分 / 请求
- TikTok Post: 2 积分 / 请求
- TikTok Profile: 2 积分 / 请求
- TikTok Search: 1 积分 / 请求
- X Post Details: 1 积分 / 请求
- YouTube Search: 1 积分 / 请求
- YouTube Video Transcripts: 2 积分 / 请求
- Ajio Product Details: 2 积分 / 请求
- Amazon Product Details: 2 积分 / 请求
- Amazon Product Reviews: 2 积分 / 请求
- Amazon Product Search: 2 积分 / 请求
- Amazon Search Autocomplete: 1 积分 / 请求
- Apple Product Details: 1 积分 / 请求
- eBay Product Details: 2 积分 / 请求
- eBay Product Search: 1 积分 / 请求
- Flipkart Product Details: 2 积分 / 请求
- Myntra Product Details: 2 积分 / 请求
- Myntra Search: 2 积分 / 请求
- Walmart Product Details: 2 积分 / 请求
- Walmart Product Search: 2 积分 / 请求
- Walmart Search Autocomplete: 1 积分 / 请求
- User-Agent Generator: 1 积分 / 请求
- Web Crawl: 1 积分 / 请求
- Web Scrape: 1 积分 / 请求
- Zillow Property Search: 2 积分 / 请求
如果你希望 Claude、Codex、Cursor、Cline/Roo、opencode 或其他 agent 直接用你的 API key 调用 SerpBase，可以使用开源 MCP server 或通用 Agent Skill。
面向支持 MCP 工具的 AI 客户端。选择搜索工具前请核对当前部署的接口目录。
适合 Claude、Codex、Cursor、Cline/Roo、Continue 等支持 MCP 的客户端。
面向能读取本地指令的 agent，也提供轻量脚本兜底；不想运行 MCP server 时可用。
适合 Codex skills、Claude Code memory、opencode、OpenClaw 风格 agent，以及可运行 shell 的工作流。
{
"mcpServers": {
"serpbase": {
"command": "python",
"args": ["-m", "serpbase_mcp"],
"env": {
"SERPBASE_API_KEY": "your_api_key"
}
}
}
}Use $serpbase-skill to search Google through SerpBase and return cited structured results.查询有效 API key 所属账户的当前额度。该请求不消耗搜索额度。
/account/credits请在 X-API-Key 请求头中传入密钥。接口不接受 URL 查询参数中的 API key。
curl https://api.serpbase.dev/account/credits \
-H "X-API-Key: your_api_key"{
"status": 0,
"credits": 12345,
"permanent_credits": 10000,
"expiring_credits": 2345,
"expiring_expires_at": 1798761600
}该接口每个账户每分钟最多调用 60 次。expiring_expires_at 为 Unix 秒级时间戳；没有有效限时额度时为 0。
接口成功响应会返回同一套顶层元数据。接口自己的数据只放在 organic、images、news、videos、places 或 place 这类结果字段里。
statusnumber必填
业务状态码，0 表示成功。
request_idstring必填
稳定请求 ID，用于支持、重试和日志关联。
elapsed_msnumber必填
网关观测到的请求执行耗时，单位毫秒。
credits_chargednumber | null必填
退款逻辑处理后实际扣除的点数。null 或 charge_status: unknown 表示尚未确认扣费。
search_typestring可选
产品返回此字段时，表示该产品的响应类型。
/google/search通过 q、语言 hl、国家 gl 和支持的设备搜索 Google 网页。结果区块取决于查询和上游响应。
/google/image/search按查询搜索 Google 图片与来源链接；返回链接不授予图片使用权。
/google/news/search按主题或关键词搜索 Google 新闻。文章和发布者字段取决于上游结果。
/google/videos/search按查询搜索 Google 视频条目；不提供视频下载或去水印服务。
/google/maps/search按查询和位置搜索 Google Maps 地点。已识别地点详情使用独立接口。
/google/maps/detail按地点 ID 查询单个 Google Maps 地点，补充地点搜索，使用独立目录请求价格。
/google/maps/reviews获取某个地点（按 data_id）的第一页 Google 地图评论：评分、内容、日期、照片和评论者信息；暂不包含商家回复。
/google/autocomplete获取 Google 查询前缀建议；建议不是搜索量统计。
/google/shopping按查询搜索 Google Shopping 条目；这是快照，不是持续价格监控。
/google/jobs按职位或关键词搜索 Google 招聘条目，有结果时返回；不提交求职申请。
/google/scholar按研究主题或关键词搜索 Google Scholar；元数据不保证论文全文访问。
/google/books按书名、作者或关键词搜索 Google Books；不提供不受限的图书下载。
/google/finance按公司或金融词查询 Google Finance；不是流式行情或交易 API。
/google/patents/detail按公开号获取一条 Google Patents 专利：标题、摘要、权利要求、发明人、申请人和各项日期。
/google/play/search按关键词搜索 Google Play 应用，返回应用名称、包名、图标和商店链接；不下载应用。
/google/play/app按包名获取一个 Google Play 应用的商店页信息：名称、开发者、简介、价格、版本、发布日期和年龄分级。
/google/trendsGoogle 趋势：最多 5 个关键词（逗号分隔）的热度走势、地区分布和相关搜索。
/google/trends/autocompleteGoogle 趋势的关键词联想主题，包含主题类型和标识。
/google/trends/trendingGoogle 趋势的实时热搜：某个国家（默认美国）过去 24 小时的上升搜索。
/bing/searchExecute Bing web searches with query, country cc, and language setlang parameters for organic search results.
/duckduckgo/search按查询及支持的市场、日期条件搜索 DuckDuckGo HTML。后续请求使用返回游标，而非页码。
/reddit/postRetrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.
/reddit/searchSearch public Reddit posts and discussion threads across subreddits by keyword query.
/tiktok/post使用帖子 ID 和用户名查询特定 TikTok 帖子，不是账号全部帖子的发现接口。
/tiktok/profile按用户名请求 TikTok 资料。数据取决于上游可访问性，不是受众历史档案。
/tiktok/search按关键词搜索 TikTok 视频：返回视频链接、文案、作者、播放、点赞、评论和分享数、话题标签与封面，默认每页 16 条。
/x/post按 ID 查询单个 X 帖子；不是关键词搜索、时间线导出或流式接口。
/youtube/searchSearch YouTube videos, Shorts, and creator channels with query and region parameters.
/youtube/transcriptsExtract timestamped multi-language video transcripts and closed captions for a YouTube video ID.
/ajio/product从 HTTPS /p/ URL 读取单件 AJIO 商品，不是目录导出。
/amazon/productRetrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.
/amazon/reviewsExtract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.
/amazon/searchSearch Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
/amazon/autocomplete根据前缀获取 Amazon 查询建议，不返回商品详情或价格历史。
/apple/product使用数字应用 ID 或 apps.apple.com URL 和国家查询 App Store 应用；不是 Apple 硬件。
/ebay/productRetrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.
/ebay/searchSearch eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.
/flipkart/product从含 /p/ 的商品 URL 读取 Flipkart 商品，使用具体 URL 而非查询词。
/myntra/product从 /buy URL 读取单个 Myntra 商品，与 Myntra 搜索接口分开。
/myntra/search使用查询或支持的搜索 URL 搜索 Myntra。支持页码，不支持游标或覆盖每页数量。
/walmart/productExtract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.
/walmart/searchSearch Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.
/walmart/autocomplete按查询获取 Walmart 搜索建议，不读取 Walmart 商品页。
/web/user-agent使用 user_agent_type 和 user_agent_count（1–5）生成桌面或移动 UA。此本地操作仍按目录价格收费。
/web/crawl从公开网站 URL 开始有界抓取；每个客户请求固定计价，不乘以返回页数。
/web/scrape按 URL 提取公开 HTTP/HTTPS 网页，支持文本、HTML、Markdown 和选择器选项；来源限制仍适用。不支持抓取谷歌页面，请使用 /google/search 等谷歌接口。
/zillow/search从支持的 Zillow homes URL 读取搜索结果；这是房源快照，不是估价或成交流。
/google/search搜索
通过 q、语言 hl、国家 gl 和支持的设备搜索 Google 网页。结果区块取决于查询和上游响应。
通过 q、语言 hl、国家 gl 和支持的设备搜索 Google 网页。结果区块取决于查询和上游响应。
qstring必填
搜索查询字符串。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
pagenumber可选
从 1 开始的页码，默认 1。
device"default" | "pc" | "mobile"可选
仅适用于 Google Search。default 表示自动路由，pc 使用桌面会话，mobile 使用移动端会话。
{
"device": "mobile",
"gl": "us",
"hl": "en",
"q": "coffee shops"
}querystring必填
请求中的标准化 query。
pagenumber必填
当前页码，从 1 开始。
organicOrganicResult[]解析到自然结果时返回。
自然搜索结果。
featured_snippetFeaturedSnippetGoogle 出现精选摘要时返回。
精选摘要答案卡片，独立于自然结果返回。
top_storiesTopStory[]SERP 包含 Top Stories 时返回。
Top Stories 模块。
people_also_askPAA[]存在 People Also Ask 时返回。
问题、答案和来源链接。
knowledge_graphKnowledgeGraph解析到知识面板时返回。
实体面板数据。
related_searchesstring[]找到相关搜索时返回。
相关搜索词。
ranknumber必填
当前响应里的 1-based 排名。
positionnumber可用时作为 rank 的别名。
给客户端使用的标准化排名别名。
titlestring必填
结果标题。
linkstring必填
parser 返回的主链接。
urlstring结果链接可归一化时返回。
规范化目标 URL，通常和 link 相同。
source_urlstring只有观测到 Google 跳转/来源 URL 时返回。
保留的原始 Google URL，用于调试和溯源。
display_urlstring当 Google 展示文本或域名可解析时返回。
展示 URL 或来源域名。
display_linkstringGoogle 展示文本存在时返回。
Google 原始展示链接文本。
snippetstring解析到摘要时返回。
自然结果摘要。
datestringGoogle 摘要中带日期时返回。
从摘要中提取的原始日期文本。
published_atstring解析到日期时作为日期别名返回。
标准化日期别名。
iconstring解析到图标或图片时返回。
结果图标 URL。
sitelinks{ title, link, url, source_url?, display_url? }[]存在站内链接时返回。
自然结果下的站内链接。
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio",
"hl": "en",
"gl": "us",
"page": 1,
"device": "default"
}'搜索 grounding、SEO 检查、答案提取。
Search 还可能返回 ai_overview、weather、finance、flight、result_stats，取决于 SERP 是否出现这些模块。
/google/image/search图片搜索
按查询搜索 Google 图片与来源链接；返回链接不授予图片使用权。
按查询搜索 Google 图片与来源链接；返回链接不授予图片使用权。
qstring必填
搜索查询字符串。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
pagenumber可选
从 1 开始的页码，默认 1。
querystring目录示例；必填规则由接口校验。
示例: "red pandas"
{
"query": "red pandas"
}querystring必填
请求中的标准化 query。
pagenumber必填
当前页码，从 1 开始。
imagesImageResult[]解析到图片结果时返回。
Google 图片结果。
ranknumber必填
当前响应里的 1-based 排名。
positionnumber可用时作为 rank 的别名。
给客户端使用的标准化排名别名。
titlestring解析到图片标题或 alt 文本时返回。
结果标题。
linkstring必填
parser 返回的主链接。
urlstring结果链接可归一化时返回。
规范化目标 URL，通常和 link 相同。
source_urlstring只有观测到 Google 跳转/来源 URL 时返回。
保留的原始 Google URL，用于调试和溯源。
display_urlstring当 Google 展示文本或域名可解析时返回。
展示 URL 或来源域名。
image_urlstring必填
完整图片 URL。
thumbnail_urlstringGoogle 暴露缩略图时返回。
缩略图 URL。
thumbnailstring可用时作为 thumbnail_url 的别名。
标准化缩略图别名。
sourcestring解析到来源文本时返回。
图片来源名称。
domainstring能从来源页面解析域名时返回。
来源页面域名。
curl -X POST 'https://api.serpbase.dev/google/image/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"red pandas"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/image/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "iphone 15 pro blue",
"hl": "en",
"gl": "us",
"page": 1
}'视觉搜索、商品监控、图片来源发现。
Google 图片存在多种页面结构，有些样本只稳定暴露 rank/link，不一定都有 url、display_url、source_url、position、thumbnail 这些别名，客户端应按可选字段处理。
/google/news/search新闻搜索
按主题或关键词搜索 Google 新闻。文章和发布者字段取决于上游结果。
按主题或关键词搜索 Google 新闻。文章和发布者字段取决于上游结果。
qstring必填
搜索查询字符串。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
pagenumber可选
从 1 开始的页码，默认 1。
querystring目录示例；必填规则由接口校验。
示例: "semiconductor supply"
{
"query": "semiconductor supply"
}querystring必填
请求中的标准化 query。
pagenumber必填
当前页码，从 1 开始。
newsNewsResult[]解析到新闻结果时返回。
Google 新闻结果。
ranknumber必填
当前响应里的 1-based 排名。
positionnumber可用时作为 rank 的别名。
给客户端使用的标准化排名别名。
titlestring必填
结果标题。
linkstring必填
parser 返回的主链接。
urlstring结果链接可归一化时返回。
规范化目标 URL，通常和 link 相同。
source_urlstring只有观测到 Google 跳转/来源 URL 时返回。
保留的原始 Google URL，用于调试和溯源。
display_urlstring当 Google 展示文本或域名可解析时返回。
展示 URL 或来源域名。
sourcestring解析到发布方文本时返回。
发布方或来源名称。
timestringGoogle 暴露时间文本时返回。
原始发布时间文本。
published_atstring解析到 time 时返回的发布时间别名。
标准化发布时间别名。
snippetstring解析到摘要时返回。
新闻摘要。
thumbnail_urlstringGoogle 暴露缩略图时返回。
缩略图 URL。
thumbnailstring可用时作为 thumbnail_url 的别名。
标准化缩略图别名。
curl -X POST 'https://api.serpbase.dev/google/news/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"semiconductor supply"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/news/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "apple event",
"hl": "en",
"gl": "us",
"page": 1
}'品牌监控、趋势跟踪、媒体发现。
source 和 time 来自 Google 紧凑元数据文本，客户端应按可选字段处理。
/google/videos/search视频搜索
按查询搜索 Google 视频条目；不提供视频下载或去水印服务。
按查询搜索 Google 视频条目；不提供视频下载或去水印服务。
qstring必填
搜索查询字符串。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
pagenumber可选
从 1 开始的页码，默认 1。
querystring目录示例；必填规则由接口校验。
示例: "how espresso machines work"
{
"query": "how espresso machines work"
}querystring必填
请求中的标准化 query。
pagenumber必填
当前页码，从 1 开始。
videosVideoResult[]解析到视频结果时返回。
Google 视频结果。
ranknumber必填
当前响应里的 1-based 排名。
positionnumber可用时作为 rank 的别名。
给客户端使用的标准化排名别名。
titlestring必填
结果标题。
linkstring必填
parser 返回的主链接。
urlstring结果链接可归一化时返回。
规范化目标 URL，通常和 link 相同。
source_urlstring只有观测到 Google 跳转/来源 URL 时返回。
保留的原始 Google URL，用于调试和溯源。
display_urlstring当 Google 展示文本或域名可解析时返回。
展示 URL 或来源域名。
sourcestring解析到来源或频道时返回。
视频来源或频道。
durationstring结果文本包含时长时返回。
视频时长文本。
timestring解析到发布时间时返回。
原始发布时间文本。
published_atstring解析到 time 时返回的时间别名。
标准化发布时间别名。
thumbnail_urlstringGoogle 暴露缩略图时返回。
缩略图 URL。
thumbnailstring可用时作为 thumbnail_url 的别名。
标准化缩略图别名。
curl -X POST 'https://api.serpbase.dev/google/videos/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"how espresso machines work"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/videos/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "python asyncio tutorial",
"hl": "en",
"gl": "us",
"page": 1
}'视频搜索、教程发现、媒体监控。
如果没有解析到专用视频卡片，parser 会对兼容的 Google 布局回退到 news 风格提取。
/google/maps/search地图搜索
按查询和位置搜索 Google Maps 地点。已识别地点详情使用独立接口。
按查询和位置搜索 Google Maps 地点。已识别地点详情使用独立接口。
qstring必填
搜索查询字符串。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
pagenumber可选
从 1 开始的页码，默认 1。
latnumber可选
地图中心纬度，必须和 lng 一起传。
lngnumber可选
地图中心经度，必须和 lat 一起传。
zoomnumber可选
地图缩放级别 1 到 21；传坐标时默认 14。
locationobject目录示例；必填规则由接口校验。
示例: {"location_query":"Seattle, WA"}
querystring目录示例；必填规则由接口校验。
示例: "coffee"
{
"location": {
"location_query": "Seattle, WA"
},
"query": "coffee"
}querystring必填
请求中的标准化 query。
pagenumber必填
当前页码，从 1 开始。
placesMapsPlace[]解析到本地地点时返回。
本地地点结果。
positionnumber仅 Maps Search 返回。
地点在本地结果列表中的排名。
namestring必填
地点名称。
titlestring必填
name 的别名。
feature_idstring必填
Google Maps feature id。
place_idstringGoogle 暴露时返回。
Google place id。
data_idstringfeature_id 的别名。
Maps data id。
cidstring可从 feature_id 解析时返回。
Google CID。
kgmidstringMaps payload 中存在时返回。
知识图谱机器 ID。
google_maps_urlstringGoogle 暴露 Maps URL 时返回。
Google Maps URL。
urlstring来自 google_maps_url，缺失时回退到 website。
地点主 URL。
ratingnumber存在评分时返回。
Google 评分。
typesstring[]存在分类时返回。
地点类型标签。
categoryobject解析到分类块时返回。
结构化分类数据。
addressstring存在地址时返回。
格式化地址。
address_componentsobject存在地址组件时返回。
街道、城市、邮编、国家代码。
plus_codeobject存在 plus code 时返回。
global_code 和 compound_code。
phonestring存在电话时返回。
本地电话号码。
phone_internationalstring存在时返回。
国际电话号码。
phone_uristring存在时返回。
电话 URI。
websitestring存在官网时返回。
商户官网。
website_domainstring存在官网域名时返回。
商户官网域名。
latitudenumber存在坐标时返回。
纬度。
longitudenumber存在坐标时返回。
经度。
imagestring存在图片时返回。
地点主图。
thumbnailstringimage 可用时作为别名返回。
主图别名。
photosMapsPhoto[]解析到照片时返回。
照片 ID、URL、尺寸和可选坐标。
hoursRecord<string,string>解析到营业时间时返回。
按星期组织的营业时间。
open_statusobject存在营业状态时返回。
营业状态文本和当前营业时间。
attributesobject[]解析到属性时返回。
分组地点属性。
related_placesobject[]存在相关地点时返回。
Maps payload 中的相关地点。
short_descriptionstring存在描述块时返回。
地点短描述。
descriptionstring存在描述块时返回。
地点长描述。
snippetstring来自 short_description 或 description。
标准化文本摘要。
timezonestring存在时返回。
地点时区。
regionstring存在时返回。
区域标签。
country_codestring存在时返回。
国家代码。
languagestring存在时返回。
Maps payload 中的语言代码。
curl -X POST 'https://api.serpbase.dev/google/maps/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"location":{"location_query":"Seattle, WA"},"query":"coffee"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/maps/search \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"q": "coffee",
"hl": "en",
"gl": "us",
"page": 1,
"lat": 37.7749,
"lng": -122.4194,
"zoom": 14
}'本地发现、门店查询、地理定向审计。
lat 和 lng 必须一起传。zoom 只有传坐标时才有效，默认 14。
/google/maps/detail地图详情
按地点 ID 查询单个 Google Maps 地点，补充地点搜索，使用独立目录请求价格。
按地点 ID 查询单个 Google Maps 地点，补充地点搜索，使用独立目录请求价格。
feature_idstring必填
使用 Maps Search 地点结果返回的 feature_id 字段，格式类似 0x...:0x...。
hlstring可选
语言代码，默认 en。
glstring可选
国家代码，默认 us。
idstring目录示例；必填规则由接口校验。
示例: "ChIJVVVVVYxK1EARyQpK5cQqEAA"
{
"id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}feature_idstring必填
地图详情请求解析出的 feature_id。
pagenumber必填
地图详情固定为 1。
placeMapsPlace解析到地点详情时返回。
单个地点详情对象。
positionnumber仅 Maps Search 返回。
地点在本地结果列表中的排名。
namestring必填
地点名称。
titlestring必填
name 的别名。
feature_idstring必填
Google Maps feature id。
place_idstringGoogle 暴露时返回。
Google place id。
data_idstringfeature_id 的别名。
Maps data id。
cidstring可从 feature_id 解析时返回。
Google CID。
kgmidstringMaps payload 中存在时返回。
知识图谱机器 ID。
google_maps_urlstringGoogle 暴露 Maps URL 时返回。
Google Maps URL。
urlstring来自 google_maps_url，缺失时回退到 website。
地点主 URL。
ratingnumber存在评分时返回。
Google 评分。
typesstring[]存在分类时返回。
地点类型标签。
categoryobject解析到分类块时返回。
结构化分类数据。
addressstring存在地址时返回。
格式化地址。
address_componentsobject存在地址组件时返回。
街道、城市、邮编、国家代码。
plus_codeobject存在 plus code 时返回。
global_code 和 compound_code。
phonestring存在电话时返回。
本地电话号码。
phone_internationalstring存在时返回。
国际电话号码。
phone_uristring存在时返回。
电话 URI。
websitestring存在官网时返回。
商户官网。
website_domainstring存在官网域名时返回。
商户官网域名。
latitudenumber存在坐标时返回。
纬度。
longitudenumber存在坐标时返回。
经度。
imagestring存在图片时返回。
地点主图。
thumbnailstringimage 可用时作为别名返回。
主图别名。
photosMapsPhoto[]解析到照片时返回。
照片 ID、URL、尺寸和可选坐标。
hoursRecord<string,string>解析到营业时间时返回。
按星期组织的营业时间。
open_statusobject存在营业状态时返回。
营业状态文本和当前营业时间。
attributesobject[]解析到属性时返回。
分组地点属性。
related_placesobject[]存在相关地点时返回。
Maps payload 中的相关地点。
short_descriptionstring存在描述块时返回。
地点短描述。
descriptionstring存在描述块时返回。
地点长描述。
snippetstring来自 short_description 或 description。
标准化文本摘要。
timezonestring存在时返回。
地点时区。
regionstring存在时返回。
区域标签。
country_codestring存在时返回。
国家代码。
languagestring存在时返回。
Maps payload 中的语言代码。
curl -X POST 'https://api.serpbase.dev/google/maps/detail' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'现有 Google 请求示例
curl -X POST https://api.serpbase.dev/google/maps/detail \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
"hl": "en",
"gl": "us"
}'地点补全、本地 CRM 数据、详情页。
使用 Maps Search 地点结果里的 feature_id 字段请求详情。格式正确但不存在的 feature_id 会返回 status 1004。
/google/maps/reviewsGoogle Maps Reviews
获取某个地点（按 data_id）的第一页 Google 地图评论：评分、内容、日期、照片和评论者信息；暂不包含商家回复。
获取某个地点（按 data_id）的第一页 Google 地图评论：评分、内容、日期、照片和评论者信息；暂不包含商家回复。
data_idstring目录示例；必填规则由接口校验。
示例: "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
dataIDstring可选
data_id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
next_page_tokenstring可选
next_token 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
topic_idstring可选
attributes.topic_id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/maps/reviews' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"data_id":"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/autocompleteGoogle Search Autocomplete
获取 Google 查询前缀建议；建议不是搜索量统计。
获取 Google 查询前缀建议；建议不是搜索量统计。
响应遵循此产品契约；暂未发布已记录的响应示例。schemas.autocomplete
curl -X POST 'https://api.serpbase.dev/google/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"weather"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/shoppingGoogle Shopping Search
按查询搜索 Google Shopping 条目；这是快照，不是持续价格监控。
按查询搜索 Google Shopping 条目；这是快照，不是持续价格监控。
querystring目录示例；必填规则由接口校验。
示例: "coffee maker"
{
"query": "coffee maker"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.product_offers
curl -X POST 'https://api.serpbase.dev/google/shopping' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"coffee maker"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/jobsGoogle Jobs Search
按职位或关键词搜索 Google 招聘条目，有结果时返回；不提交求职申请。
按职位或关键词搜索 Google 招聘条目，有结果时返回；不提交求职申请。
querystring目录示例；必填规则由接口校验。
示例: "software engineer"
{
"query": "software engineer"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.jobs
curl -X POST 'https://api.serpbase.dev/google/jobs' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"software engineer"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/scholarGoogle Scholar Search
按研究主题或关键词搜索 Google Scholar；元数据不保证论文全文访问。
按研究主题或关键词搜索 Google Scholar；元数据不保证论文全文访问。
querystring目录示例；必填规则由接口校验。
示例: "quantum computing"
{
"query": "quantum computing"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.serp_organic
curl -X POST 'https://api.serpbase.dev/google/scholar' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"quantum computing"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/booksGoogle Books Search
按书名、作者或关键词搜索 Google Books；不提供不受限的图书下载。
按书名、作者或关键词搜索 Google Books；不提供不受限的图书下载。
querystring目录示例；必填规则由接口校验。
示例: "clean code"
{
"query": "clean code"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.serp_organic
curl -X POST 'https://api.serpbase.dev/google/books' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"clean code"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/financeGoogle Finance Search
按公司或金融词查询 Google Finance；不是流式行情或交易 API。
按公司或金融词查询 Google Finance；不是流式行情或交易 API。
querystring目录示例；必填规则由接口校验。
示例: "apple stock"
{
"query": "apple stock"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.serp_organic
curl -X POST 'https://api.serpbase.dev/google/finance' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"apple stock"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/patents/detailGoogle Patent Details
按公开号获取一条 Google Patents 专利：标题、摘要、权利要求、发明人、申请人和各项日期。
按公开号获取一条 Google Patents 专利：标题、摘要、权利要求、发明人、申请人和各项日期。
idstring目录示例；必填规则由接口校验。
示例: "US8244737B2"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
lanaguagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
patent_idstring可选
id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "US8244737B2"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/patents/detail' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"US8244737B2"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/play/searchGoogle Play Search
按关键词搜索 Google Play 应用，返回应用名称、包名、图标和商店链接；不下载应用。
按关键词搜索 Google Play 应用，返回应用名称、包名、图标和商店链接；不下载应用。
qstring目录示例；必填规则由接口校验。
示例: "coffee"
agestring可选
attributes.age 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
store_devicestring可选
attributes.store_device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"q": "coffee"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/play/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"coffee"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/play/appGoogle Play App Details
按包名获取一个 Google Play 应用的商店页信息：名称、开发者、简介、价格、版本、发布日期和年龄分级。
按包名获取一个 Google Play 应用的商店页信息：名称、开发者、简介、价格、版本、发布日期和年龄分级。
idstring目录示例；必填规则由接口校验。
示例: "com.spotify.music"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "com.spotify.music"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/play/app' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"com.spotify.music"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/trendsGoogle Trends
Google 趋势：最多 5 个关键词（逗号分隔）的热度走势、地区分布和相关搜索。
Google 趋势：最多 5 个关键词（逗号分隔）的热度走势、地区分布和相关搜索。
qstring目录示例；必填规则由接口校验。
示例: "coffee"
catstring可选
category_id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
datestring可选
time_range 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
geostring可选
attributes.geo 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gpropstring可选
attributes.gprop 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
include_low_search_volumestring可选
attributes.include_low_search_volume 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
regionstring可选
attributes.region 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
tzstring可选
attributes.tz 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"q": "coffee"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/trends' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"coffee"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/trends/autocompleteGoogle Trends Autocomplete
Google 趋势的关键词联想主题，包含主题类型和标识。
Google 趋势的关键词联想主题，包含主题类型和标识。
qstring目录示例；必填规则由接口校验。
示例: "coffee"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"q": "coffee"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/trends/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"coffee"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/google/trends/trendingGoogle Trends Trending Now
Google 趋势的实时热搜：某个国家（默认美国）过去 24 小时的上升搜索。
Google 趋势的实时热搜：某个国家（默认美国）过去 24 小时的上升搜索。
glstring目录示例；必填规则由接口校验。
示例: "us"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
geostring可选
attributes.geo 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
google_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
gooogle_domainstring可选
locale.engine_domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hoursstring可选
attributes.hours 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"gl": "us"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/google/trends/trending' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"gl":"us"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/bing/searchBing Web Search
Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.
Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.
该接口正在开发调整中，目前已暂停调用，恢复后会重新开放。
glstring目录示例；必填规则由接口校验。
示例: "us"
hlstring目录示例；必填规则由接口校验。
示例: "en"
qstring目录示例；必填规则由接口校验。
示例: "artificial intelligence"
ccstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countstring可选
attributes.count 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
firststring可选
attributes.first 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
latstring可选
attributes.lat 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
lonstring可选
attributes.lon 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mktstring可选
attributes.mkt 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
resultsstring可选
attributes.results 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
safeSearchstring可选
attributes.safeSearch 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"gl": "us",
"hl": "en",
"q": "artificial intelligence"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/duckduckgo/searchDuckDuckGo Search
按查询及支持的市场、日期条件搜索 DuckDuckGo HTML。后续请求使用返回游标，而非页码。
按查询及支持的市场、日期条件搜索 DuckDuckGo HTML。后续请求使用返回游标，而非页码。
querystring目录示例；必填规则由接口校验。
示例: "coffee shops"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
dfstring可选
attributes.df 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
klstring可选
attributes.kl 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
next_page_tokenstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"query": "coffee shops"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/duckduckgo/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"coffee shops"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/reddit/postReddit Post & Comments
Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.
Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.
urlstring目录示例；必填规则由接口校验。
示例: "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/reddit/post' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/reddit/searchReddit Search
Search public Reddit posts and discussion threads across subreddits by keyword query.
Search public Reddit posts and discussion threads across subreddits by keyword query.
qstring目录示例；必填规则由接口校验。
示例: "best mechanical keyboard"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"q": "best mechanical keyboard"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/reddit/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"best mechanical keyboard"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/tiktok/postTikTok Post
使用帖子 ID 和用户名查询特定 TikTok 帖子，不是账号全部帖子的发现接口。
使用帖子 ID 和用户名查询特定 TikTok 帖子，不是账号全部帖子的发现接口。
idstring目录示例；必填规则由接口校验。
示例: "7123456789012345678"
usernamestring目录示例；必填规则由接口校验。
示例: "tiktok"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
post_idstring可选
id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "7123456789012345678",
"username": "tiktok"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/tiktok/post' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"7123456789012345678","username":"tiktok"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/tiktok/profileTikTok Profile
按用户名请求 TikTok 资料。数据取决于上游可访问性，不是受众历史档案。
按用户名请求 TikTok 资料。数据取决于上游可访问性，不是受众历史档案。
usernamestring目录示例；必填规则由接口校验。
示例: "tiktok"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"username": "tiktok"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/tiktok/profile' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"username":"tiktok"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/tiktok/searchTikTok Search
按关键词搜索 TikTok 视频：返回视频链接、文案、作者、播放、点赞、评论和分享数、话题标签与封面，默认每页 16 条。
按关键词搜索 TikTok 视频：返回视频链接、文案、作者、播放、点赞、评论和分享数、话题标签与封面，默认每页 16 条。
qstring目录示例；必填规则由接口校验。
示例: "pasta recipe"
countinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
keywordstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
next_page_tokenstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"q": "pasta recipe"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/tiktok/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"pasta recipe"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/x/postX Post Details
按 ID 查询单个 X 帖子；不是关键词搜索、时间线导出或流式接口。
按 ID 查询单个 X 帖子；不是关键词搜索、时间线导出或流式接口。
idstring目录示例；必填规则由接口校验。
示例: "1234567890123456789"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
tweetIdstring可选
id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "1234567890123456789"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/x/post' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"1234567890123456789"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/youtube/searchYouTube Search
Search YouTube videos, Shorts, and creator channels with query and region parameters.
Search YouTube videos, Shorts, and creator channels with query and region parameters.
glstring目录示例；必填规则由接口校验。
示例: "us"
qstring目录示例；必填规则由接口校验。
示例: "nextjs tutorial"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
search_querystring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
spstring可选
attributes.sp 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"gl": "us",
"q": "nextjs tutorial"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/youtube/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"gl":"us","q":"nextjs tutorial"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/youtube/transcriptsYouTube Video Transcripts
Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.
Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.
idstring目录示例；必填规则由接口校验。
示例: "dQw4w9WgXcQ"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
vstring可选
id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
video_linkstring可选
url 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "dQw4w9WgXcQ"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/youtube/transcripts' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"dQw4w9WgXcQ"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/ajio/productAjio Product Details
从 HTTPS /p/ URL 读取单件 AJIO 商品，不是目录导出。
从 HTTPS /p/ URL 读取单件 AJIO 商品，不是目录导出。
urlstring目录示例；必填规则由接口校验。
示例: "https://www.ajio.com/sample/p/1234567890"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://www.ajio.com/sample/p/1234567890"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/ajio/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.ajio.com/sample/p/1234567890"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/amazon/productAmazon Product Details
Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.
Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.
asinstring目录示例；必填规则由接口校验。
示例: "B08N5WRWNW"
domainstring目录示例；必填规则由接口校验。
示例: "amazon.com"
amazon_domainstring可选
domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
typestring可选
search_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"asin": "B08N5WRWNW",
"domain": "amazon.com"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/amazon/reviewsAmazon Product Reviews
Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.
Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.
asinstring目录示例；必填规则由接口校验。
示例: "B08N5WRWNW"
domainstring目录示例；必填规则由接口校验。
示例: "amazon.com"
amazon_domainstring可选
domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
filter_by_starstring可选
review_rating 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
reviewer_typestring可选
review_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
typestring可选
search_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"asin": "B08N5WRWNW",
"domain": "amazon.com"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/reviews' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/amazon/searchAmazon Product Search
Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.
domainstring目录示例；必填规则由接口校验。
示例: "amazon.com"
qstring目录示例；必填规则由接口校验。
示例: "wireless headphones"
amazon_domainstring可选
domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
typestring可选
search_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"domain": "amazon.com",
"q": "wireless headphones"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"amazon.com","q":"wireless headphones"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/amazon/autocompleteAmazon Search Autocomplete
根据前缀获取 Amazon 查询建议，不返回商品详情或价格历史。
根据前缀获取 Amazon 查询建议，不返回商品详情或价格历史。
prefixstring目录示例；必填规则由接口校验。
示例: "laptop"
amazon_domainstring可选
domain 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
midstring可选
marketplace_id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
typestring可选
search_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"prefix": "laptop"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/amazon/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"prefix":"laptop"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/apple/productApple Product Details
使用数字应用 ID 或 apps.apple.com URL 和国家查询 App Store 应用；不是 Apple 硬件。
使用数字应用 ID 或 apps.apple.com URL 和国家查询 App Store 应用；不是 Apple 硬件。
idstring目录示例；必填规则由接口校验。
示例: "284882215"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
product_idstring可选
id 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
typestring可选
search_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "284882215"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/apple/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"284882215"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/ebay/producteBay Product Details
Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.
Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.
domainstring目录示例；必填规则由接口校验。
示例: "ebay.com"
idstring目录示例；必填规则由接口校验。
示例: "123456789012"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"domain": "ebay.com",
"id": "123456789012"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/ebay/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"ebay.com","id":"123456789012"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/ebay/searcheBay Product Search
Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.
Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.
domainstring目录示例；必填规则由接口校验。
示例: "ebay.com"
querystring目录示例；必填规则由接口校验。
示例: "vintage watch"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"domain": "ebay.com",
"query": "vintage watch"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/ebay/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"domain":"ebay.com","query":"vintage watch"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/flipkart/productFlipkart Product Details
从含 /p/ 的商品 URL 读取 Flipkart 商品，使用具体 URL 而非查询词。
从含 /p/ 的商品 URL 读取 Flipkart 商品，使用具体 URL 而非查询词。
urlstring目录示例；必填规则由接口校验。
示例: "https://www.flipkart.com/item/p/itm1234567890"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://www.flipkart.com/item/p/itm1234567890"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/flipkart/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.flipkart.com/item/p/itm1234567890"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/myntra/productMyntra Product Details
从 /buy URL 读取单个 Myntra 商品，与 Myntra 搜索接口分开。
从 /buy URL 读取单个 Myntra 商品，与 Myntra 搜索接口分开。
urlstring目录示例；必填规则由接口校验。
示例: "https://www.myntra.com/shoes/nike/123456/buy"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://www.myntra.com/shoes/nike/123456/buy"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/myntra/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.myntra.com/shoes/nike/123456/buy"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/myntra/searchMyntra Search
使用查询或支持的搜索 URL 搜索 Myntra。支持页码，不支持游标或覆盖每页数量。
使用查询或支持的搜索 URL 搜索 Myntra。支持页码，不支持游标或覆盖每页数量。
querystring目录示例；必填规则由接口校验。
示例: "shoes"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"query": "shoes"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/myntra/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"shoes"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/walmart/productWalmart Product Details
Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.
Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.
idstring目录示例；必填规则由接口校验。
示例: "133497934"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"id": "133497934"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/walmart/product' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"id":"133497934"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/walmart/searchWalmart Product Search
Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.
Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.
querystring目录示例；必填规则由接口校验。
示例: "coffee maker"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"query": "coffee maker"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/walmart/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"coffee maker"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/walmart/autocompleteWalmart Search Autocomplete
按查询获取 Walmart 搜索建议，不读取 Walmart 商品页。
按查询获取 Walmart 搜索建议，不读取 Walmart 商品页。
querystring目录示例；必填规则由接口校验。
示例: "laptop"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"query": "laptop"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/walmart/autocomplete' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"query":"laptop"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/web/user-agentUser-Agent Generator
使用 user_agent_type 和 user_agent_count（1–5）生成桌面或移动 UA。此本地操作仍按目录价格收费。
使用 user_agent_type 和 user_agent_count（1–5）生成桌面或移动 UA。此本地操作仍按目录价格收费。
user_agent_countnumber目录示例；必填规则由接口校验。
示例: 1
user_agent_typestring目录示例；必填规则由接口校验。
示例: "desktop"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
uanuminteger可选
user_agent_count 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
uatypestring可选
user_agent_type 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"user_agent_count": 1,
"user_agent_type": "desktop"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/web/user-agent' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"user_agent_count":1,"user_agent_type":"desktop"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/web/crawlWeb Crawl
从公开网站 URL 开始有界抓取；每个客户请求固定计价，不乘以返回页数。
从公开网站 URL 开始有界抓取；每个客户请求固定计价，不乘以返回页数。
urlstring目录示例；必填规则由接口校验。
示例: "https://example.com"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://example.com"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/web/crawl' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://example.com"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/web/scrapeWeb Scrape
按 URL 提取公开 HTTP/HTTPS 网页，支持文本、HTML、Markdown 和选择器选项；来源限制仍适用。不支持抓取谷歌页面，请使用 /google/search 等谷歌接口。
按 URL 提取公开 HTTP/HTTPS 网页，支持文本、HTML、Markdown 和选择器选项；来源限制仍适用。不支持抓取谷歌页面，请使用 /google/search 等谷歌接口。
urlstring目录示例；必填规则由接口校验。
示例: "https://example.com"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
custom_headersobject可选
headers 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://example.com"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/web/scrape' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://example.com"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
/zillow/searchZillow Property Search
从支持的 Zillow homes URL 读取搜索结果；这是房源快照，不是估价或成交流。
从支持的 Zillow homes URL 读取搜索结果；这是房源快照，不是估价或成交流。
urlstring目录示例；必填规则由接口校验。
示例: "https://www.zillow.com/homes/Seattle-WA_rb/"
countrystring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
cursorstring可选
pagination.cursor 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
devicestring可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
glstring可选
locale.country 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
hlstring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
htmlboolean可选
include_html 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
languagestring可选
locale.language 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
limitinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
markdownboolean可选
include_markdown 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
mobileboolean可选
options.device 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
numinteger可选
pagination.limit 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
pageinteger可选
pagination.page 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
qstring可选
query 的兼容写法。每次使用其中一种；接口会校验本产品支持的参数与取值。
{
"url": "https://www.zillow.com/homes/Seattle-WA_rb/"
}响应遵循此产品契约；暂未发布已记录的响应示例。schemas.source_data
curl -X POST 'https://api.serpbase.dev/zillow/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"url":"https://www.zillow.com/homes/Seattle-WA_rb/"}'从目录示例开始调用，并查看接口实际返回的 JSON。
示例展示请求参数用法，不代表完整契约。接口会校验已知字段，并允许额外参数。
errorstring必填
可读错误信息。
请求成功完成。请检查产品响应字段；no_results 本身不能证明 HTTP 404。
扣费
请求体或参数缺失/无效。
不扣费先修正请求再发
API key 缺失、无效或已撤销。
不扣费先修正请求再发
网关未注册此路由或资源不存在。
不扣费先修正请求再发
账号余额不足。
不扣费先修正请求再发
QPS 或并发限制已触发。
不扣费可以重试
意外的内部服务错误。
不扣费可以重试
worker 返回上游抓取或解析错误。
不扣费可以重试
当前没有可用 worker 会话。
不扣费可以重试
网关等待 worker 结果超时。
不扣费可以重试
{
"status": 1001,
"error": "unauthorized",
"request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
"elapsed_ms": 0,
"credits_charged": 0
}每个接口响应都带有这些响应头，客户端可以据此控制节奏、判断是否重试，不用解析错误文字。
- X-RateLimit-Limit
- 你的账户每秒允许的请求数。
- X-RateLimit-Remaining
- 当前这一秒还能再发多少个请求。
- Retry-After
- 被拒绝时，建议等几秒再发。
- X-SerpBase-Retryable
- true 表示原样重发有可能成功；false 表示请求本身要改。