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-USVolver a la traducción
Descripción general
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.
Alcance y límites
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.
- Adecuada para
- 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.
- No usar para
- 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.
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 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.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
- Search keyword
keywordObligatoriostringGoogle search keyword to collect. Each task accepts one keyword from 1 to 512 characters.Ejemplocartier - Expected result count
crawl_numObligatoriointegerExpected 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.Rango1–200Ejemplo1 - Required words
all_these_wordsOpcionalstringWords 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_wordsOpcionalstringCandidate words of which at least one should appear. Separate multiple words with spaces. Leave empty to omit this filter. - Excluded words
none_of_these_wordsOpcionalstringWords that must not appear in the result. Separate multiple words with spaces. Leave empty to omit this filter. - Exact phrase
this_exact_word_or_phraseOpcionalstringExact word or phrase that must appear as a whole. Leave empty to omit this filter. - Number range
numbers_ranging_fromOpcionalstringNumber range to keep in the results, such as 2024..2026. Leave empty to omit this filter. - File type
file_typeOpcionalstringKeep only results of this file type, such as Adobe Acrobat PDF (.pdf). Leave empty to omit this filter. - Interface language
interface_languageOpcionalstringGoogle interface language, such as English. Leave empty to omit this filter. - Result language
search_languageOpcionalstringLanguage of the search results, such as English. Leave empty to omit this filter. - Last update
last_updateOpcionalstringLast-update filter value, such as w. Leave empty to omit this filter. - Search type
order_typeOpcionalstringSearch type value, such as ALL. Leave empty to omit this filter. - Region
regionOpcionalstringRestrict results to a region, such as United States. Leave empty to omit this filter. - Site or domain
site_or_domainOpcionalstringRestrict the search to a site or domain, such as instagram.com. Leave empty to omit this filter. - Start date
start_dateOpcionalstringStart of the date range in YYYY-MM-DD. Leave empty to omit this filter. - End date
end_dateOpcionalstringEnd of the date range in YYYY-MM-DD. Leave empty to omit this filter. - Keyword location
terms_appearingOpcionalstringWhere the keyword should appear, such as anywhere in the page. Leave empty to omit this filter. - Usage rights
usage_rightsOpcionalstringUsage-rights filter, such as not filtered by license. Leave empty to omit this filter.
Salida
Estructura de campos de un único registro, generada a partir del output.schema del 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
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"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
}Integración
Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino. Esta App se ejecuta de forma asíncrona y se puede cancelar a mitad de camino: Tras la cancelación, la ejecución se detiene. Los registros ya entregados se conservan y se facturan.
Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.
Configuración del cliente
Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/google-search-results",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Deja que la IA lo configure por ti
¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)
detail.access.mcp.composeHint
Precios
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 10 registros; cualquier unidad parcial se redondea a 10 registros.
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.
Ver créditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.