Google Search Results
Give a keyword and optional search filters to get public Google listings with rank, snippet, links, and on-page search features.
Original · en-USZur Übersetzung
Übersicht
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 title | Snippet | Result URL | Keyword | Result type | Rank |
|---|---|---|---|---|---|
| Cartier | 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 | https://www.cartier.com/en-us/home | cartier | organic | 1 |
| Clash de Cartier | Discover 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/ | cartier | organic | 2 |
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.
Anwendungsbereich & Grenzen
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.
- Geeignet für
- 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.
- Nicht verwenden für
- 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.
Fehlerbehandlung
Vom Entwickler deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.
- 1If no listings are returned, shorten the keyword or remove date, region, language, and site limits, then retry.
- 2Retry later after rate limiting, temporary unavailability, or a timeout. If authentication fails, verify the API Key configured for the execution environment.
- 3Resubmit the same input after a failed or expired task. Keep completed records after a partial success.
Eingabe
Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.
- Search keyword
keywordErforderlichstringGoogle search keyword to collect. Each task accepts one keyword from 1 to 512 characters.Beispielcartier - Expected result count
crawl_numErforderlichintegerExpected 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.Bereich1–200Beispiel1 - Required words
all_these_wordsOptionalstringWords that must all appear in the result. Separate multiple words with spaces. Leave empty to omit this filter. - Any of these words
any_of_these_wordsOptionalstringCandidate words of which at least one should appear. Separate multiple words with spaces. Leave empty to omit this filter. - Excluded words
none_of_these_wordsOptionalstringWords that must not appear in the result. Separate multiple words with spaces. Leave empty to omit this filter. - Exact phrase
this_exact_word_or_phraseOptionalstringExact word or phrase that must appear as a whole. Leave empty to omit this filter. - Number range
numbers_ranging_fromOptionalstringNumber range to keep in the results, such as 2024..2026. Leave empty to omit this filter. - File type
file_typeOptionalstringKeep only results of this file type, such as Adobe Acrobat PDF (.pdf). Leave empty to omit this filter. - Interface language
interface_languageOptionalstringGoogle interface language, such as English. Leave empty to omit this filter. - Result language
search_languageOptionalstringLanguage of the search results, such as English. Leave empty to omit this filter. - Last update
last_updateOptionalstringLast-update filter value, such as w. Leave empty to omit this filter. - Search type
order_typeOptionalstringSearch type value, such as ALL. Leave empty to omit this filter. - Region
regionOptionalstringRestrict results to a region, such as United States. Leave empty to omit this filter. - Site or domain
site_or_domainOptionalstringRestrict the search to a site or domain, such as instagram.com. Leave empty to omit this filter. - Start date
start_dateOptionalstringStart of the date range in YYYY-MM-DD. Leave empty to omit this filter. - End date
end_dateOptionalstringEnd of the date range in YYYY-MM-DD. Leave empty to omit this filter. - Keyword location
terms_appearingOptionalstringWhere the keyword should appear, such as anywhere in the page. Leave empty to omit this filter. - Usage rights
usage_rightsOptionalstringUsage-rights filter, such as not filtered by license. Leave empty to omit this filter.
Ausgabe
Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.
- AI overview
aio_contentstringAI overview body shown on the results page - AI source title
aio_source_titlestringTitle of a source cited by the AI overview - AI source snippet
aio_source_title_descriptionstringSnippet of a source cited by the AI overview - AI source URL
aio_source_title_urlstringPage link of a source cited by the AI overview
Beispieldaten
Aus output.schema erzeugt. Felder ohne Beispielwert verwenden strukturelle Platzhalter.
{
"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
}Integration
Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung. Diese App läuft asynchron und kann zwischendurch abgebrochen werden: Nach dem Abbruch stoppt der Lauf. Bereits gelieferte Datensätze bleiben erhalten und werden abgerechnet.
Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.
Client-Konfiguration
Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/google-search-results",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Lassen Sie die KI die Einrichtung übernehmen
Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Der Prompt weist die KI an, Ihren API Key bei Ihnen zu erfragen, damit Zugangsdaten nie im Chatverlauf oder in geteilten Konfigurationen landen.)
detail.access.mcp.composeHint
Preise
Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 10 Datensätze; jede angefangene Einheit wird auf 10 Datensätze aufgerundet.
Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.
Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.
Credits ansehenJetzt ausprobieren
Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.