muapi Logomuapi Logo
muapi Logomuapi Logo

Google Organic SERP API（Google 自然搜索结果 API）: AI大規模言語モデル

通过 MuAPI 标准化的 SERP API 获取特定位置的 Google 自然搜索结果。可选择设备和深度，按次查询付费，并接收结构化 JSON。

📝

概要

このモデルについて

Google Organic SERP 会根据关键词、位置、语言和设备返回 Google 自然搜索结果的标准化快照。每条结果都包含排名位置、域名、标题、URL、描述和选定的 SERP 特征标记，适用于排名检查、SEO 研究和搜索结果监控。

1查看目标关键词当前的 Google 搜索结果
2按市场比较桌面端和移动端排名
3构建 SEO 仪表盘和关键词监控工作流
4识别排名 URL 和 SERP 特征覆盖情况
💰

料金と価値

コスト分析

muapiappFrom $0.001000 per 10-result lookup

Depth-based pricing with final reconciliation after the task completes.

** 競合サービスの料金は類似のモデル構成および利用ティアに基づいて算出された推定値です。

⚙️

技術詳細

設定スキーマ

关键词string

要检查的 Google 搜索查询。

デフォルト値best ai video generator
位置Enum（213個の選択肢）

搜索所针对的国家或地区。

デフォルト値United States
言語Enum（129個の選択肢）

搜索使用的语言。

デフォルト値English
设备Enum（2個の選択肢）

-

デフォルト値desktop
结果深度int

要请求的自然搜索结果位置数量。

デフォルト値10
📖

実装ガイド

開発者ドキュメント

使用方法 Google Organic SERP

  1. 选择关键词：提供要检查的搜索查询。
  2. 设置市场：按名称选择国家和语言，例如 "United States" 和 "English"。
  3. 选择设备和深度：请求桌面端或移动端结果，并将深度设置为 10 到 100。
  4. 异步リクエスト送信：端点会返回 request_id；你可以轮询结果 URL，或提供 webhook URL，以获取完成后的 JSON 快照。
curl -X POST https://api.muapi.ai/api/v1/seo-google-serp \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "best ai video generator",
    "location": "United States",
    "language": "English",
    "device": "desktop",
    "depth": 10
  }'
❓

よくある質問

FAQ

Google Organic SERP API 会返回什么？

它会返回标准化 JSON 快照，其中包含关键词、市场设置、结果深度，以及每条返回的 SERP 项目的选定字段，包括排名、域名、标题、URL、描述和 SERP 特征标记。

可以请求移动端结果吗？

可以。将 `device` 设置为 `mobile` 获取移动端 Google 结果快照；保留为 `desktop` 则获取桌面端结果。

如何选择国家或城市？

在 `location` 中传入国家名称，例如 "India" 或 "Germany" —— MuAPI 会在内部将其映射到上游位置代码。默认值为 "United States"。目前不提供超出国家级别的城市或地区定位。

请求如何计费？

MuAPI 会根据请求的深度预留一笔金额，然后将 UsageLog 结算为该查询返回的实际上游任务成本。

结果準備好后，可以通过通知代替轮询吗？

可以。在リクエスト送信后附加 `?webhook=YOUR_URL`，查询完成时 MuAPI 会将已完成的 JSON 快照 POST 到该 URL，无需轮询结果端点。