logo
JP

Google Search Results

Give a keyword and optional search filters to get public Google listings with rank, snippet, links, and on-page search features.

原文 · en-US訳文に戻す

データ収集Search & SEOGoogle SearchWeb Page Content
開発者
hello_moto
料金
$0.006 / 10 件から
最終更新
2026-09-18

概要

Google search is where people decide which page to open: the title, the snippet, the visible URL, and where the listing sits on the page. This app turns one public search keyword into a structured table of those listings so SEO, brand, and competitive work can start from the same results a searcher would see.

Each row keeps the keyword beside the listing, so later comparisons stay attached to the query that produced them. Ads, AI overviews, related questions, and sitelinks stay in the same table when Google shows them, which makes this a search-results workbook rather than a copy of any destination page.

Data notes

Each row is one public Google search listing for the submitted keyword. Organic hits, ads, AI overview blocks, related questions, and related queries can appear as separate rows, distinguished by Result type. Result title, Snippet, Displayed URL, Rank, and Result URL are the text shown on the results page at collection time, not a later crawl of the destination page. Collected at, Cleaned at, and Updated at are returned without a timezone. Keyword, Required words, Region, and similar columns repeat the search settings across rows from the same query.

The collection does not cover signed-in results, private pages, or the full body of a destination page. Paid product fields, AI overview fields, related questions, related queries, and sitelinks are often empty on ordinary organic rows.

What a result looks like

Each row is one public Google search listing.

Result titleSnippetResult URLKeywordResult typeRank
CartierMovement, fluidity, and color: the new Clash de Cartier creations amplify this distinctive jewelry collection. Shop the collection · Clash de Cartier ring, ... Bracelets Cartier watch collections Rings Necklaces Luxury Sunglasses Collection Luxury Watches for himhttps://www.cartier.com/en-us/homecartierorganic1
Clash de CartierDiscover the Clash de Cartier jewelry collection, where spheres, beads, and clean lines meet in rings, bracelets, and necklaces.https://www.cartier.com/en-us/jewelry/collections/clash-de-cartier/cartierorganic2

Displayed URL, Sitelink title 1, and Interface language are also available when the listing shows them.

Use cases

  • For rank tracking, group rows by Keyword and read Rank, Result title, and Result URL to see which pages occupy the first results.
  • For SERP feature review, filter Result type and compare Ad title, AI overview, and Related question with the organic Result title.
  • For brand monitoring, keep Keyword beside Displayed URL and Result title to see which domains the query actually surfaces.
  • For landing-page work, open Result URL with Sitelink title 1 and Sitelink title 2 to rebuild the public cards that searchers see.

適用範囲と境界

One Google search keyword per task with an expected result count from 1 to 200. Results are returned in complete pages of 10 and may be rounded up. Collection covers at most 20 Google result pages at 10 results per page. Public Google search listings only.

  • 適している用途
  • When you need public Google search listings for one keyword, including titles, snippets, links, and ranks.
  • When you need to observe ads, AI overviews, related questions, and sitelinks alongside organic results.
  • 適さない用途
  • When you need an instant handful of results — this App runs as a background collection task.
  • When you need signed-in, private, or full destination-page body content — results cover public search listings only.

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1If no listings are returned, shorten the keyword or remove date, region, language, and site limits, then retry.
  2. 2Retry later after rate limiting, temporary unavailability, or a timeout. If authentication fails, verify the API Key configured for the execution environment.
  3. 3Resubmit the same input after a failed or expired task. Keep completed records after a partial success.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

  • Search keywordkeyword必須string
    Google search keyword to collect. Each task accepts one keyword from 1 to 512 characters.
    例cartier
  • Expected result countcrawl_num必須integer
    Expected number of search results, from 1 to 200. Results are returned in complete pages of 10, so the actual count may be rounded up. A partial page is still billed as 10 results.
    範囲1–200例1
  • Required wordsall_these_words任意string
    Words that must all appear in the result. Separate multiple words with spaces. Leave empty to omit this filter.
  • Any of these wordsany_of_these_words任意string
    Candidate words of which at least one should appear. Separate multiple words with spaces. Leave empty to omit this filter.
  • Excluded wordsnone_of_these_words任意string
    Words that must not appear in the result. Separate multiple words with spaces. Leave empty to omit this filter.
  • Exact phrasethis_exact_word_or_phrase任意string
    Exact word or phrase that must appear as a whole. Leave empty to omit this filter.
  • Number rangenumbers_ranging_from任意string
    Number range to keep in the results, such as 2024..2026. Leave empty to omit this filter.
  • File typefile_type任意string
    Keep only results of this file type, such as Adobe Acrobat PDF (.pdf). Leave empty to omit this filter.
  • Interface languageinterface_language任意string
    Google interface language, such as English. Leave empty to omit this filter.
  • Result languagesearch_language任意string
    Language of the search results, such as English. Leave empty to omit this filter.
  • Last updatelast_update任意string
    Last-update filter value, such as w. Leave empty to omit this filter.
  • Search typeorder_type任意string
    Search type value, such as ALL. Leave empty to omit this filter.
  • Regionregion任意string
    Restrict results to a region, such as United States. Leave empty to omit this filter.
  • Site or domainsite_or_domain任意string
    Restrict the search to a site or domain, such as instagram.com. Leave empty to omit this filter.
  • Start datestart_date任意string
    Start of the date range in YYYY-MM-DD. Leave empty to omit this filter.
  • End dateend_date任意string
    End of the date range in YYYY-MM-DD. Leave empty to omit this filter.
  • Keyword locationterms_appearing任意string
    Where the keyword should appear, such as anywhere in the page. Leave empty to omit this filter.
  • Usage rightsusage_rights任意string
    Usage-rights filter, such as not filtered by license. Leave empty to omit this filter.

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

  • AI overviewaio_contentstring
    AI overview body shown on the results page
  • AI source titleaio_source_titlestring
    Title of a source cited by the AI overview
  • AI source snippetaio_source_title_descriptionstring
    Snippet of a source cited by the AI overview
  • AI source URLaio_source_title_urlstring
    Page link of a source cited by the AI overview

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example
{
  "aio_content": "<aio_content>",
  "aio_source_title": "<aio_source_title>",
  "aio_source_title_description": "<aio_source_title_description>",
  "aio_source_title_url": "<aio_source_title_url>",
  "all_these_words": "cartier",
  "any_of_these_words": "<any_of_these_words>",
  "average_rating": "<average_rating>",
  "biz_id": "cartier",
  "clean_update_time": "2026-08-25T16:23:21",
  "crawl_time": "2026-08-25T16:23:18",
  "current_page": "1",
  "detail_url": "https://www.cartier.com/en-us/home",
  "displayed_url": "www.cartier.com",
  "end_date": "<end_date>",
  "file_type": "any format",
  "has_next_page": "true",
  "interface_language": "English",
  "keyword": "cartier",
  "last_update": "<last_update>",
  "none_of_these_words": "<none_of_these_words>",
  "numbers_ranging_from": "<numbers_ranging_from>",
  "order_type": "all",
  "pagination_times": "10",
  "paid_product_price": "<paid_product_price>",
  "paid_product_provider": "<paid_product_provider>",
  "paid_product_title": "<paid_product_title>",
  "paid_title_url": "<paid_title_url>",
  "partition_day": "2026-08-25",
  "people_also_ask_answer": "<people_also_ask_answer>",
  "people_also_ask_date": "<people_also_ask_date>",
  "people_also_ask_question": "<people_also_ask_question>",
  "people_also_ask_title": "<people_also_ask_title>",
  "people_also_ask_url": "<people_also_ask_url>",
  "rating_count": "<rating_count>",
  "region": "any region",
  "related_queries_title": "<related_queries_title>",
  "related_queries_url": "<related_queries_url>",
  "result_description": "Movement, fluidity, and color: the new Clash de Cartier creations amplify this distinctive jewelry collection. Shop the collection · Clash de Cartier ring, ... Bracelets Cartier watch collections Rings Necklaces Luxury Sunglasses Collection Luxury Watches for him",
  "result_position": "1",
  "result_title": "Cartier",
  "result_type": "organic",
  "results_per_page": "10",
  "search_language": "any language",
  "site_link_title_1": "Bracelets",
  "site_link_title_2": "Cartier watch collections",
  "site_link_title_3": "Rings",
  "site_link_title_4": "Necklaces",
  "site_link_url_1": "https://www.cartier.com/en-us/jewelry/bracelets/",
  "site_link_url_2": "https://www.cartier.com/en-us/watches/collections/",
  "site_link_url_3": "https://www.cartier.com/en-us/jewelry/rings/",
  "site_link_url_4": "https://www.cartier.com/en-us/jewelry/necklaces/",
  "site_or_domain": "<site_or_domain>",
  "sr_updated_time": "2026-08-25T16:23:22",
  "start_date": "<start_date>",
  "task_item": "cartier",
  "terms_appearing": "anywhere in the page",
  "this_exact_word_or_phrase": "<this_exact_word_or_phrase>",
  "usage_rights": "not filtered by license",
  "view_count": "<view_count>",
  "task_no_data": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます：キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/google-search-results",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

10 returned records

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 10 件を 1 つの課金単位とし、端数は 10 件に切り上げて課金されます。

$0.006/ 10 件
Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
$0.006 / 10 件から