Parameter defines the maximum number of results to return. (e.g., 40 (default) returns 40 results and 100 returns 100 results).
end_date
End Date
Parameter defines the end date for which you want the search results to conclude. The format for this field is YYYYMMDD.
Example: 20221231
To set the date for Today / Single Day, you should set end_date as start_date + 1 day.
platform
Platform
Parameter defines the target platform where ads are displayed. When not set, it will return results from all platforms (default).
Available options:
PLAY - Google Play
MAPS - Google Maps
SEARCH - Google Search
SHOPPING - Google Shopping
YOUTUBE - YouTube.
start_date
Start Date
Parameter defines the start date for which you want the search results to begin. The format for this field is YYYYMMDD.
Example: 20221201
advertiser_id
Advertiser Id
Parameter defines the Google Advertiser ID. It can be found in the Ads Transparency Center advertiser URL.
For example, the advertiser ID for the URL https://adstransparency.google.com/advertiser/AR17828074650563772417 is AR17828074650563772417(Tesla Inc).
It accepts either a single ID or multiple IDs separated by commas (,). Example,
Single ID: AR17828074650563772417
Multiple IDs: AR17828074650563772417,AR03911981557522366465,...
creative_format
Creative Format
Parameter defines the format you want to filter by. Only search results with a similar format will be returned.
Available options:
text - Text
image - Image
video - Video
next_page_token
Next Page Token
Parameter defines the next page token. It is used for retrieving the next page results.
この SERP ランディングページでは主に Google 検索機能を紹介しています。同じ API フローで、通常の自然検索結果、広告、強調スニペット、ローカル結果、関連質問、画像、ニュースなど、さまざまな SERP モジュールのデータを取得できます。実際の返却内容は、キーワード、地域、検索タイプによって変わります。
API は構造化された検索データを返します。通常は検索パラメータ、自然検索結果のタイトル、リンク、スニペット、順位に加え、ページによっては広告、ローカル結果、関連検索、People Also Ask なども含まれます。これにより、自前でページ解析を行わなくても、そのまま監視、分析、保存、後続処理に利用できます。