SerpBase
POST のみ

API ドキュメント

構造化された検索結果、リクエストパラメーターと応答ステータス。

Base URL
https://api.serpbase.dev
認証ヘッダー
X-API-Key: <API_KEY>
課金
リクエスト単位の料金。実行済みの失敗も課金対象になる場合があります
認証

API Keys で秘密のキーを取得し、X-API-Key で送信します。URL や公開コードには含めないでください。製品ごとのメソッドとパラメーターに従い、HTTP 200 だけで成功と判断せず status と error を確認します。Playground もクレジットを消費する場合があります。

elapsed_ms

共通レスポンス構造

credits_charged

リクエスト単位の料金。実行済みの失敗も課金対象になる場合があります

request_id

サポート用リクエスト ID

最小リクエスト
bash
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 未満は変更なし。既存の高い上限は下げません。無制限ではありません。

対象となる累計チャージ額(USD)引き上げ後の最低 QPS
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

入金確認済みの USD credit_pack と auto_topup のみ対象です。サブスクリプション(Starter Boost 含む)、贈与、ギフトコードは対象外です。残高は累計 USD 支払額ではありません。USD 以外を換算せず USD として数えません。

同じアカウントの全キー、製品、ゲートウェイは一つの QPS 上限を共有します。キーを増やしても上限は増えません。

QPS 引き上げは入金確認後であり、決済画面から戻っただけでは反映されません。現在の上限はアカウントに表示されるサーバー報告値です。キーへの同期が遅れる場合があります。

課金モデルと控除ルール

カタログのリクエスト単価と課金情報の読み方。

各リクエストにはカタログの固定料金が適用され、返却ページ数による課金ではありません。Web Crawl と User Agent は現在それぞれ 1 クレジットです。User Agent は無料ではありません。取得元と対象の識別情報で確認された真の不存在は課金対象です。no_results、HTTP 404、hydration や解析データの欠落だけでは不存在を証明できません。実行済みの失敗も課金される場合があり、すべての失敗の返金は保証されません。credits_charged は実際の課金額を示し、0 は報告上のゼロ、null や未指定は不明です。charge_status が UNKNOWN なら数値があっても不明のままです。記録を確認し request_id を添えてサポートへ連絡してください。返金を推測したり無条件に再試行したりしないでください。

エージェント連携

Claude、Codex、Cursor、Cline/Roo、opencode などから API キーで直接呼び出すには、オープンソース MCP サーバーまたは移植可能なスキルを利用できます。

MCP 設定
json
{
  "mcpServers": {
    "serpbase": {
      "command": "python",
      "args": ["-m", "serpbase_mcp"],
      "env": {
        "SERPBASE_API_KEY": "your_api_key"
      }
    }
  }
}
スキルの指示例
text
Use $serpbase-skill to search Google through SerpBase and return cited structured results.
アカウント残高

有効な API key が属するアカウントの現在のクレジット残高を取得します。このリクエストは検索クレジットを消費しません。

GET
0 credits
/account/credits

X-API-Key ヘッダーでキーを渡してください。URL クエリパラメータの API key は受け付けません。

bash
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: your_api_key"
json
{
  "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 などに入ります。

status
必須
number

必須

ビジネスステータスコード。0 は成功です。

request_id
必須
string

必須

サポート、リトライ、ログ照合に使うリクエスト ID。

elapsed_ms
必須
number

必須

ゲートウェイが観測した実行所要時間。単位はミリ秒。

credits_charged
必須
number | null

必須

返金ロジック適用後に課金されたクレジット数。

search_type
任意
string

任意

製品が返す場合の、製品固有のレスポンス型。

エンドポイント
1 credits
Search
/google/search

q、言語 hl、国 gl、対応デバイスで Google ウェブ検索を実行します。結果の構成はクエリと取得元の応答によります。

1 credits
画像検索
/google/image/search

Google 画像と参照リンクを検索します。リンクの取得は画像の利用権を付与しません。

1 credits
ニュース検索
/google/news/search

トピックやキーワードで Google ニュースを検索します。記事と発行元の項目は取得元の結果によります。

1 credits
動画検索
/google/videos/search

Google の動画一覧を検索します。動画のダウンロードや透かし除去は提供しません。

2 credits
Maps 検索
/google/maps/search

クエリと位置で Google Maps の場所を検索します。特定の場所の詳細には別のエンドポイントを使います。

3 credits
Maps 詳細
/google/maps/detail

場所 ID で Google Maps の単一地点を取得します。場所検索を補完し、独自の単価が適用されます。

2 credits
Google Maps Reviews
/google/maps/reviews

場所(data_id 指定)の Google マップのクチコミ 1 ページ目を取得します。評価、本文、日付、写真、投稿者情報を返します。オーナーの返信はまだ含みません。

1 credits
Google Search Autocomplete
/google/autocomplete

接頭辞から Google の検索候補を取得します。検索ボリュームの測定値ではありません。

2 credits
Google Shopping Search
/google/shopping

Google Shopping を検索します。検索時点の情報であり、継続的な価格監視ではありません。

2 credits
Google Jobs Search
/google/jobs

職種やキーワードで Google 求人を検索します。存在する求人を返し、応募の送信は行いません。

2 credits
Google Scholar Search
/google/scholar

研究テーマやキーワードで Google Scholar を検索します。メタデータは論文全文へのアクセスを保証しません。

1 credits
Google Books Search
/google/books

書名、著者、キーワードで Google Books を検索します。書籍の無制限ダウンロードは含みません。

1 credits
Google Finance Search
/google/finance

企業名や金融用語で Google Finance を検索します。ストリーミング相場や取引 API ではありません。

2 credits
Google Patent Details
/google/patents/detail

公開番号で Google Patents の特許を 1 件取得します。タイトル、要約、請求項、発明者、出願人、各日付を返します。

1 credits
Google Play Search
/google/play/search

キーワードで Google Play のアプリを検索し、アプリ名、パッケージ名、アイコン、ストアのリンクを返します。アプリのダウンロードは行いません。

1 credits
Google Play App Details
/google/play/app

パッケージ名で Google Play のアプリを 1 件取得し、名前、開発者、説明、価格、バージョン、公開日、年齢区分を返します。

2 credits
Google Trends
/google/trends

Google トレンドで最大 5 語(カンマ区切り)の人気度の推移、地域別の関心度、関連キーワードを取得します。

2 credits
Google Trends Autocomplete
/google/trends/autocomplete

Google トレンドでキーワードに関連するトピック候補を、種類と識別子付きで返します。

2 credits
Google Trends Trending Now
/google/trends/trending

Google トレンドで、指定した国(既定は米国)の過去 24 時間の急上昇ワードを取得します。

開発中・一時停止中
Bing Web Search
/bing/search

Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.

1 credits
DuckDuckGo Search
/duckduckgo/search

クエリと対応する市場・日付条件で DuckDuckGo HTML を検索します。続きはページ番号ではなく返却カーソルを使います。

2 credits
Reddit Post & Comments
/reddit/post

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

1 credits
Reddit Search
/reddit/search

Search public Reddit posts and discussion threads across subreddits by keyword query.

2 credits
TikTok Post
/tiktok/post

投稿 ID とユーザー名で特定の TikTok 投稿を取得します。プロフィール全体の投稿検索ではありません。

2 credits
TikTok Profile
/tiktok/profile

ユーザー名で TikTok プロフィールを取得します。取得元へのアクセス状況に依存し、視聴者履歴のアーカイブではありません。

1 credits
TikTok Search
/tiktok/search

キーワードで TikTok 動画を検索します。動画リンク、キャプション、投稿者、再生・いいね・コメント・シェア数、ハッシュタグ、カバー画像を返します(既定 16 件/ページ)。

1 credits
X Post Details
/x/post

ID で単一の X 投稿を取得します。キーワード検索、タイムラインのエクスポート、ストリーミングではありません。

1 credits
YouTube Search
/youtube/search

Search YouTube videos, Shorts, and creator channels with query and region parameters.

2 credits
YouTube Video Transcripts
/youtube/transcripts

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

2 credits
Ajio Product Details
/ajio/product

HTTPS /p/ URL から AJIO の単一商品を取得します。カタログのエクスポートではありません。

2 credits
Amazon Product Details
/amazon/product

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

2 credits
Amazon Product Reviews
/amazon/reviews

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

2 credits
Amazon Product Search
/amazon/search

Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.

1 credits
Amazon Search Autocomplete
/amazon/autocomplete

接頭辞から Amazon の検索候補を取得します。商品詳細や価格履歴ではありません。

1 credits
Apple Product Details
/apple/product

数値 ID または apps.apple.com URL と国で App Store アプリを取得します。Apple のハードウェアではありません。

2 credits
eBay Product Details
/ebay/product

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

1 credits
eBay Product Search
/ebay/search

Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.

2 credits
Flipkart Product Details
/flipkart/product

/p/ を含む URL から Flipkart 商品を取得します。検索語ではなく特定の URL を指定します。

2 credits
Myntra Product Details
/myntra/product

/buy URL から Myntra の単一商品を取得します。Myntra 検索とは別です。

2 credits
Myntra Search
/myntra/search

クエリまたは対応する URL で Myntra を検索します。ページ番号に対応しますが、カーソルやページサイズ変更には対応しません。

2 credits
Walmart Product Details
/walmart/product

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

2 credits
Walmart Product Search
/walmart/search

Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.

1 credits
Walmart Search Autocomplete
/walmart/autocomplete

クエリから Walmart の検索候補を取得します。商品ページは取得しません。

1 credits
User-Agent Generator
/web/user-agent

user_agent_type と user_agent_count(1–5)でデスクトップまたはモバイル UA を生成します。ローカル処理でもカタログ料金が適用されます。

1 credits
Web Crawl
/web/crawl

公開サイト URL から範囲を限定してクロールします。リクエストごとの固定料金で、返却ページ数は乗算されません。

1 credits
Web Scrape
/web/scrape

公開 HTTP/HTTPS ページを URL で抽出します。テキスト、HTML、Markdown、セレクターに対応し、取得元の制約は適用されます。Google のページには対応していません。/google/search などの Google エンドポイントをご利用ください。

2 credits
Zillow Property Search
/zillow/search

対応する Zillow homes URL から検索結果を取得します。物件のスナップショットであり、査定や取引フィードではありません。

POST
利用可能
/google/image/search

画像検索

Google 画像と参照リンクを検索します。リンクの取得は画像の利用権を付与しません。

type
images
result
images
課金
1 credits

Google 画像と参照リンクを検索します。リンクの取得は画像の利用権を付与しません。

パラメータ
q
必須
string

必須

検索クエリ文字列。

hl
任意
string

任意

言語コード。デフォルトは en。

gl
任意
string

任意

国コード。デフォルトは us。

page
任意
number

任意

1 始まりのページ番号。デフォルトは 1。

query
例
string

カタログの例。必須項目は API が検証します。

例: "red pandas"

json
{
  "query": "red pandas"
}
Playground で実行
レスポンスフィールド
query
必須
string

必須

リクエストから正規化されたクエリ。

page
必須
number

必須

現在の 1 始まりのページ番号。

images
任意
ImageResult[]

画像結果が解析された場合。

Google 画像検索結果。

ImageResult 結果アイテム構造
rank
必須
number

必須

このレスポンス内の 1 始まりの順位。

position
任意
number

利用可能な場合は rank のエイリアス。

position を期待するクライアント向けの正規化順位。

title
任意
string

画像タイトルまたは alt テキストを解析できる場合。

結果タイトル。

link
必須
string

必須

parser が返す主リンク。

url
任意
string

結果リンクを正規化できる場合に返ります。

正規化されたターゲット URL。通常は link と同じです。

source_url
任意
string

Google のリダイレクト元 URL がある場合のみ返ります。

デバッグと出所確認のために保持される元の Google URL。

display_url
任意
string

Google の表示テキストまたはドメインを取得できる場合。

表示 URL またはソースドメイン。

image_url
必須
string

必須

元画像の URL。

thumbnail_url
任意
string

Google がサムネイルを公開している場合。

サムネイル URL。

thumbnail
任意
string

利用可能な場合は thumbnail_url のエイリアス。

正規化されたサムネイルエイリアス。

source
任意
string

出典テキストが解析された場合。

画像の出典ラベル。

domain
任意
string

出典ページのドメインを導出できる場合。

出典ページのドメイン。

コードとレスポンスの例
bash
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 リクエスト例
bash
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 は任意項目として扱ってください。

POST
利用可能
/google/news/search

ニュース検索

トピックやキーワードで Google ニュースを検索します。記事と発行元の項目は取得元の結果によります。

type
news
result
news
課金
1 credits

トピックやキーワードで Google ニュースを検索します。記事と発行元の項目は取得元の結果によります。

パラメータ
q
必須
string

必須

検索クエリ文字列。

hl
任意
string

任意

言語コード。デフォルトは en。

gl
任意
string

任意

国コード。デフォルトは us。

page
任意
number

任意

1 始まりのページ番号。デフォルトは 1。

query
例
string

カタログの例。必須項目は API が検証します。

例: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Playground で実行
レスポンスフィールド
query
必須
string

必須

リクエストから正規化されたクエリ。

page
必須
number

必須

現在の 1 始まりのページ番号。

news
任意
NewsResult[]

ニュース結果が解析された場合。

Google ニュースの結果。

NewsResult 結果アイテム構造
rank
必須
number

必須

このレスポンス内の 1 始まりの順位。

position
任意
number

利用可能な場合は rank のエイリアス。

position を期待するクライアント向けの正規化順位。

title
必須
string

必須

結果タイトル。

link
必須
string

必須

parser が返す主リンク。

url
任意
string

結果リンクを正規化できる場合に返ります。

正規化されたターゲット URL。通常は link と同じです。

source_url
任意
string

Google のリダイレクト元 URL がある場合のみ返ります。

デバッグと出所確認のために保持される元の Google URL。

display_url
任意
string

Google の表示テキストまたはドメインを取得できる場合。

表示 URL またはソースドメイン。

source
任意
string

発行元のテキストが解析された場合。

発行元・出典ラベル。

time
任意
string

Google が時刻テキストを公開する場合。

公開時刻の原文。

published_at
任意
string

解析時刻があればその別名。

正規化された公開時刻の別名。

snippet
任意
string

スニペットが解析された場合。

記事の要約スニペット。

thumbnail_url
任意
string

Google がサムネイルを公開している場合。

サムネイル URL。

thumbnail
任意
string

利用可能な場合は thumbnail_url のエイリアス。

正規化されたサムネイルエイリアス。

コードとレスポンスの例
bash
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 リクエスト例
bash
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
  }'
注記

ブランド監視、トレンド追跡、メディア発見。

出典と時刻は Google の短いメタデータから解析するため、両方とも任意項目として扱ってください。

POST
利用可能
/google/videos/search

動画検索

Google の動画一覧を検索します。動画のダウンロードや透かし除去は提供しません。

type
videos
result
videos
課金
1 credits

Google の動画一覧を検索します。動画のダウンロードや透かし除去は提供しません。

パラメータ
q
必須
string

必須

検索クエリ文字列。

hl
任意
string

任意

言語コード。デフォルトは en。

gl
任意
string

任意

国コード。デフォルトは us。

page
任意
number

任意

1 始まりのページ番号。デフォルトは 1。

query
例
string

カタログの例。必須項目は API が検証します。

例: "how espresso machines work"

json
{
  "query": "how espresso machines work"
}
Playground で実行
レスポンスフィールド
query
必須
string

必須

リクエストから正規化されたクエリ。

page
必須
number

必須

現在の 1 始まりのページ番号。

videos
任意
VideoResult[]

動画結果が解析された場合。

Google 動画検索結果。

VideoResult 結果アイテム構造
rank
必須
number

必須

このレスポンス内の 1 始まりの順位。

position
任意
number

利用可能な場合は rank のエイリアス。

position を期待するクライアント向けの正規化順位。

title
必須
string

必須

結果タイトル。

link
必須
string

必須

parser が返す主リンク。

url
任意
string

結果リンクを正規化できる場合に返ります。

正規化されたターゲット URL。通常は link と同じです。

source_url
任意
string

Google のリダイレクト元 URL がある場合のみ返ります。

デバッグと出所確認のために保持される元の Google URL。

display_url
任意
string

Google の表示テキストまたはドメインを取得できる場合。

表示 URL またはソースドメイン。

source
任意
string

出典・チャンネルを解析できる場合。

動画の出典・チャンネル名。

duration
任意
string

結果テキストに長さが含まれる場合。

動画の長さのテキスト。

time
任意
string

投稿時刻を解析できる場合。

投稿時刻の原文。

published_at
任意
string

解析時刻があればその別名。

正規化された投稿時刻の別名。

thumbnail_url
任意
string

Google がサムネイルを公開している場合。

サムネイル URL。

thumbnail
任意
string

利用可能な場合は thumbnail_url のエイリアス。

正規化されたサムネイルエイリアス。

コードとレスポンスの例
bash
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 リクエスト例
bash
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
  }'
注記

動画検索、チュートリアル発見、メディア監視。

専用の動画カードがなければ、対応する Google レイアウトでニュース形式の抽出を試みます。

POST
利用可能
/google/maps/detail

Maps 詳細

場所 ID で Google Maps の単一地点を取得します。場所検索を補完し、独自の単価が適用されます。

type
maps_detail
result
place
課金
3 credits

場所 ID で Google Maps の単一地点を取得します。場所検索を補完し、独自の単価が適用されます。

パラメータ
feature_id
必須
string

必須

Maps Search の地点結果で返る feature_id フィールドを使用します。形式は 0x...:0x...。

hl
任意
string

任意

言語コード。デフォルトは en。

gl
任意
string

任意

国コード。デフォルトは us。

id
例
string

カタログの例。必須項目は API が検証します。

例: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json
{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}
Playground で実行
レスポンスフィールド
feature_id
必須
string

必須

地図詳細リクエストから解決した feature_id。

page
必須
number

必須

地図詳細では常に 1。

place
任意
MapsPlace

場所の詳細が解析された場合。

単一の場所の詳細オブジェクト。

MapsPlace 結果アイテム構造
position
任意
number

Maps 検索のみ。

地域結果での場所の順位。

name
必須
string

必須

場所の名前。

title
必須
string

必須

name の別名。

feature_id
必須
string

必須

Google Maps の feature ID。

place_id
任意
string

Google が公開する場合。

Google の場所 ID。

data_id
任意
string

feature_id の別名。

Maps のデータ ID。

cid
任意
string

可能なら feature_id から導出。

Google の CID。

kgmid
任意
string

Maps データに存在する場合。

ナレッジグラフのマシン ID。

google_maps_url
任意
string

Google が Maps URL を公開する場合。

Google Maps の URL。

url
任意
string

google_maps_url、なければ website。

場所の主 URL。

rating
任意
number

評価がある場合。

Google の評価。

types
任意
string[]

カテゴリーがある場合。

場所の種類ラベル。

category
任意
object

カテゴリーが解析された場合。

構造化カテゴリーデータ。

address
任意
string

住所がある場合。

整形された住所。

address_components
任意
object

住所の構成要素がある場合。

通り、市、郵便番号、国コード。

plus_code
任意
object

Plus Code がある場合。

グローバル・複合 Plus Code。

phone
任意
string

電話番号がある場合。

現地形式の電話番号。

phone_international
任意
string

存在する場合。

国際形式の電話番号。

phone_uri
任意
string

存在する場合。

電話の URI。

website
任意
string

ウェブサイトがある場合。

事業者のウェブサイト。

website_domain
任意
string

サイトのドメインがある場合。

事業者サイトのドメイン。

latitude
任意
number

座標がある場合。

緯度。

longitude
任意
number

座標がある場合。

経度。

image
任意
string

画像がある場合。

場所の主画像。

thumbnail
任意
string

画像があれば image の別名。

主画像の別名。

photos
任意
MapsPhoto[]

写真が解析された場合。

写真 ID、URL、サイズ、任意の座標。

hours
任意
Record<string,string>

営業時間が解析された場合。

曜日別の営業時間。

open_status
任意
object

営業状態がある場合。

営業状態と現在の営業時間。

attributes
任意
object[]

属性が解析された場合。

グループ化された場所の属性。

related_places
任意
object[]

関連する場所がある場合。

Maps データの関連する場所。

short_description
任意
string

説明ブロックがある場合。

場所の短い説明。

description
任意
string

説明ブロックがある場合。

場所の詳しい説明。

snippet
任意
string

short_description、なければ description。

正規化された要約。

timezone
任意
string

存在する場合。

場所のタイムゾーン。

region
任意
string

存在する場合。

地域ラベル。

country_code
任意
string

存在する場合。

国コード。

language
任意
string

存在する場合。

Maps データの言語コード。

コードとレスポンスの例
bash
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 リクエスト例
bash
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 検索結果の feature_id を使って詳細を取得します。形式が正しくても不明な feature_id は status 1004 を返します。

POST
利用可能
/google/maps/reviews

Google Maps Reviews

場所(data_id 指定)の Google マップのクチコミ 1 ページ目を取得します。評価、本文、日付、写真、投稿者情報を返します。オーナーの返信はまだ含みません。

type
google_maps_reviews
result
schemas.source_data
課金
2 credits

場所(data_id 指定)の Google マップのクチコミ 1 ページ目を取得します。評価、本文、日付、写真、投稿者情報を返します。オーナーの返信はまだ含みません。

パラメータ
data_id
例
string

カタログの例。必須項目は API が検証します。

例: "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

dataID
任意
string

任意

data_id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

google_domain
任意
string

任意

locale.engine_domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gooogle_domain
任意
string

任意

locale.engine_domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

next_page_token
任意
string

任意

next_token: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

results
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

topic_id
任意
string

任意

attributes.topic_id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/google/autocomplete

Google Search Autocomplete

接頭辞から Google の検索候補を取得します。検索ボリュームの測定値ではありません。

type
google_autocomplete
result
schemas.autocomplete
課金
1 credits

接頭辞から Google の検索候補を取得します。検索ボリュームの測定値ではありません。

パラメータ
query
例
string

カタログの例。必須項目は API が検証します。

例: "weather"

json
{
  "query": "weather"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.autocomplete

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/google/patents/detail

Google Patent Details

公開番号で Google Patents の特許を 1 件取得します。タイトル、要約、請求項、発明者、出願人、各日付を返します。

type
google_patents_detail
result
schemas.source_data
課金
2 credits

公開番号で Google Patents の特許を 1 件取得します。タイトル、要約、請求項、発明者、出願人、各日付を返します。

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "US8244737B2"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

google_domain
任意
string

任意

locale.engine_domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gooogle_domain
任意
string

任意

locale.engine_domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

lanaguage
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

patent_id
任意
string

任意

id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

results
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "US8244737B2"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/google/play/app

Google Play App Details

パッケージ名で Google Play のアプリを 1 件取得し、名前、開発者、説明、価格、バージョン、公開日、年齢区分を返します。

type
google_play_app
result
schemas.source_data
課金
1 credits

パッケージ名で Google Play のアプリを 1 件取得し、名前、開発者、説明、価格、バージョン、公開日、年齢区分を返します。

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "com.spotify.music"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

google_domain
任意
string

任意

locale.engine_domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gooogle_domain
任意
string

任意

locale.engine_domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

results
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "com.spotify.music"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/reddit/post

Reddit Post & Comments

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

type
reddit_post
result
schemas.source_data
課金
2 credits

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

パラメータ
url
例
string

カタログの例。必須項目は API が検証します。

例: "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "url": "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/tiktok/post

TikTok Post

投稿 ID とユーザー名で特定の TikTok 投稿を取得します。プロフィール全体の投稿検索ではありません。

type
tiktok_post
result
schemas.source_data
課金
2 credits

投稿 ID とユーザー名で特定の TikTok 投稿を取得します。プロフィール全体の投稿検索ではありません。

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "7123456789012345678"

username
例
string

カタログの例。必須項目は API が検証します。

例: "tiktok"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

post_id
任意
string

任意

id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "7123456789012345678",
  "username": "tiktok"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/tiktok/profile

TikTok Profile

ユーザー名で TikTok プロフィールを取得します。取得元へのアクセス状況に依存し、視聴者履歴のアーカイブではありません。

type
tiktok_profile
result
schemas.source_data
課金
2 credits

ユーザー名で TikTok プロフィールを取得します。取得元へのアクセス状況に依存し、視聴者履歴のアーカイブではありません。

パラメータ
username
例
string

カタログの例。必須項目は API が検証します。

例: "tiktok"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "username": "tiktok"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/x/post

X Post Details

ID で単一の X 投稿を取得します。キーワード検索、タイムラインのエクスポート、ストリーミングではありません。

type
x_post
result
schemas.source_data
課金
1 credits

ID で単一の X 投稿を取得します。キーワード検索、タイムラインのエクスポート、ストリーミングではありません。

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "1234567890123456789"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

tweetId
任意
string

任意

id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "1234567890123456789"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/youtube/transcripts

YouTube Video Transcripts

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

type
youtube_transcripts
result
schemas.source_data
課金
2 credits

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "dQw4w9WgXcQ"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

v
任意
string

任意

id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

video_link
任意
string

任意

url: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "dQw4w9WgXcQ"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/ajio/product

Ajio Product Details

HTTPS /p/ URL から AJIO の単一商品を取得します。カタログのエクスポートではありません。

type
ajio_product
result
schemas.source_data
課金
2 credits

HTTPS /p/ URL から AJIO の単一商品を取得します。カタログのエクスポートではありません。

パラメータ
url
例
string

カタログの例。必須項目は API が検証します。

例: "https://www.ajio.com/sample/p/1234567890"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "url": "https://www.ajio.com/sample/p/1234567890"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/amazon/product

Amazon Product Details

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

type
amazon_product
result
schemas.source_data
課金
2 credits

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

パラメータ
asin
例
string

カタログの例。必須項目は API が検証します。

例: "B08N5WRWNW"

domain
例
string

カタログの例。必須項目は API が検証します。

例: "amazon.com"

amazon_domain
任意
string

任意

domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

type
任意
string

任意

search_type: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "asin": "B08N5WRWNW",
  "domain": "amazon.com"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/amazon/reviews

Amazon Product Reviews

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

type
amazon_reviews
result
schemas.source_data
課金
2 credits

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

パラメータ
asin
例
string

カタログの例。必須項目は API が検証します。

例: "B08N5WRWNW"

domain
例
string

カタログの例。必須項目は API が検証します。

例: "amazon.com"

amazon_domain
任意
string

任意

domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

filter_by_star
任意
string

任意

review_rating: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

reviewer_type
任意
string

任意

review_type: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

type
任意
string

任意

search_type: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "asin": "B08N5WRWNW",
  "domain": "amazon.com"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/amazon/autocomplete

Amazon Search Autocomplete

接頭辞から Amazon の検索候補を取得します。商品詳細や価格履歴ではありません。

type
amazon_autocomplete
result
schemas.source_data
課金
1 credits

接頭辞から Amazon の検索候補を取得します。商品詳細や価格履歴ではありません。

パラメータ
prefix
例
string

カタログの例。必須項目は API が検証します。

例: "laptop"

amazon_domain
任意
string

任意

domain: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mid
任意
string

任意

marketplace_id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

type
任意
string

任意

search_type: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "prefix": "laptop"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/apple/product

Apple Product Details

数値 ID または apps.apple.com URL と国で App Store アプリを取得します。Apple のハードウェアではありません。

type
apple_product
result
schemas.source_data
課金
1 credits

数値 ID または apps.apple.com URL と国で App Store アプリを取得します。Apple のハードウェアではありません。

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "284882215"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

product_id
任意
string

任意

id: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

type
任意
string

任意

search_type: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "284882215"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/ebay/product

eBay Product Details

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

type
ebay_product
result
schemas.source_data
課金
2 credits

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

パラメータ
domain
例
string

カタログの例。必須項目は API が検証します。

例: "ebay.com"

id
例
string

カタログの例。必須項目は API が検証します。

例: "123456789012"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "domain": "ebay.com",
  "id": "123456789012"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/flipkart/product

Flipkart Product Details

/p/ を含む URL から Flipkart 商品を取得します。検索語ではなく特定の URL を指定します。

type
flipkart_product
result
schemas.source_data
課金
2 credits

/p/ を含む URL から Flipkart 商品を取得します。検索語ではなく特定の URL を指定します。

パラメータ
url
例
string

カタログの例。必須項目は API が検証します。

例: "https://www.flipkart.com/item/p/itm1234567890"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "url": "https://www.flipkart.com/item/p/itm1234567890"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/myntra/product

Myntra Product Details

/buy URL から Myntra の単一商品を取得します。Myntra 検索とは別です。

type
myntra_product
result
schemas.source_data
課金
2 credits

/buy URL から Myntra の単一商品を取得します。Myntra 検索とは別です。

パラメータ
url
例
string

カタログの例。必須項目は API が検証します。

例: "https://www.myntra.com/shoes/nike/123456/buy"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "url": "https://www.myntra.com/shoes/nike/123456/buy"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/walmart/product

Walmart Product Details

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

type
walmart_product
result
schemas.source_data
課金
2 credits

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

パラメータ
id
例
string

カタログの例。必須項目は API が検証します。

例: "133497934"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "id": "133497934"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/walmart/autocomplete

Walmart Search Autocomplete

クエリから Walmart の検索候補を取得します。商品ページは取得しません。

type
walmart_autocomplete
result
schemas.source_data
課金
1 credits

クエリから Walmart の検索候補を取得します。商品ページは取得しません。

パラメータ
query
例
string

カタログの例。必須項目は API が検証します。

例: "laptop"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "query": "laptop"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/web/user-agent

User-Agent Generator

user_agent_type と user_agent_count(1–5)でデスクトップまたはモバイル UA を生成します。ローカル処理でもカタログ料金が適用されます。

type
web_user_agent
result
schemas.source_data
課金
1 credits

user_agent_type と user_agent_count(1–5)でデスクトップまたはモバイル UA を生成します。ローカル処理でもカタログ料金が適用されます。

パラメータ
user_agent_count
例
number

カタログの例。必須項目は API が検証します。

例: 1

user_agent_type
例
string

カタログの例。必須項目は API が検証します。

例: "desktop"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

uanum
任意
integer

任意

user_agent_count: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

uatype
任意
string

任意

user_agent_type: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "user_agent_count": 1,
  "user_agent_type": "desktop"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/web/crawl

Web Crawl

公開サイト URL から範囲を限定してクロールします。リクエストごとの固定料金で、返却ページ数は乗算されません。

type
web_crawl
result
schemas.source_data
課金
1 credits

公開サイト URL から範囲を限定してクロールします。リクエストごとの固定料金で、返却ページ数は乗算されません。

パラメータ
url
例
string

カタログの例。必須項目は API が検証します。

例: "https://example.com"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "url": "https://example.com"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

POST
利用可能
/web/scrape

Web Scrape

公開 HTTP/HTTPS ページを URL で抽出します。テキスト、HTML、Markdown、セレクターに対応し、取得元の制約は適用されます。Google のページには対応していません。/google/search などの Google エンドポイントをご利用ください。

type
web_scrape
result
schemas.source_data
課金
1 credits

公開 HTTP/HTTPS ページを URL で抽出します。テキスト、HTML、Markdown、セレクターに対応し、取得元の制約は適用されます。Google のページには対応していません。/google/search などの Google エンドポイントをご利用ください。

パラメータ
url
例
string

カタログの例。必須項目は API が検証します。

例: "https://example.com"

country
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

cursor
任意
string

任意

pagination.cursor: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

custom_headers
任意
object

任意

headers: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

device
任意
string

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

gl
任意
string

任意

locale.country: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

hl
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

html
任意
boolean

任意

include_html: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

language
任意
string

任意

locale.language: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

limit
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

markdown
任意
boolean

任意

include_markdown: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

mobile
任意
boolean

任意

options.device: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

num
任意
integer

任意

pagination.limit: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

page
任意
integer

任意

pagination.page: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

q
任意
string

任意

query: 別名は一度に一方だけを使います。API は対応パラメーターと値を検証します。

json
{
  "url": "https://example.com"
}
Playground で実行

レスポンスは製品契約に従います。記録されたレスポンス例はまだ公開されていません。schemas.source_data

コードとレスポンスの例
bash
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 応答を確認します。

例は完全な契約ではありません。既知の項目は検証され、追加パラメーターは許可されます。

エラー
error
必須
string

必須

人が読めるエラーメッセージ。

0
SUCCESS

リクエストは成功しました。製品固有の結果を確認してください。no_results だけでは HTTP 404 を証明しません。

課金あり

1000
INVALID_REQUEST

本文やパラメーターが欠落または無効です。

課金なしリクエストを修正してから

1001
UNAUTHORIZED

API キーが欠落、無効、または失効しています。

課金なしリクエストを修正してから

1004
NOT_FOUND

ゲートウェイのルートまたはカタログにリソースがありません。

課金なしリクエストを修正してから

1020
INSUFFICIENT_CREDITS

アカウント残高が不足しています。

課金なしリクエストを修正してから

1029
RATE_LIMITED

QPS または同時実行数の上限を超えました。

課金なし再試行可

1500
INTERNAL_ERROR

予期しない内部サーバーエラー。

課金なし再試行可

1502
UPSTREAM_FAILED

ワーカーが取得元の取得・解析エラーを返しました。

課金なし再試行可

1503
SERVICE_UNAVAILABLE

利用可能なワーカーセッションがありません。

課金なし再試行可

1504
UPSTREAM_TIMEOUT

ゲートウェイがワーカーの結果待ちでタイムアウトしました。

課金なし再試行可

json
{
  "status": 1001,
  "error": "unauthorized",
  "request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
  "elapsed_ms": 0,
  "credits_charged": 0
}
レスポンスヘッダー

すべての製品レスポンスにこれらのヘッダーが含まれ、メッセージを解析せずに送信間隔の調整や再試行の判断ができます。

X-RateLimit-Limit
アカウントが許可する毎秒のリクエスト数。
X-RateLimit-Remaining
現在の 1 秒間に残っているリクエスト数。
Retry-After
拒否時に再送まで待つ秒数。
X-SerpBase-Retryable
true なら同じリクエストの再送で成功し得ます。false ならリクエスト自体の修正が必要です。
サポートへの連絡時
レスポンスの request_id(成功・失敗どちらにもあります)と呼び出し時刻を添えてください。それがあれば該当リクエストを数秒で特定できます。
プライバシーと保持
検索クエリは課金、デバッグ、不正利用防止、アカウントログのために記録される場合があります。保持期間はプライバシーページをご確認ください。