logo
ES

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

Desarrollador
hello_moto
Precios
Desde 0,006 US$ / 10 registros
Última actualización
2026-09-18

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 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.

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.

  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.

Entrada

Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.

  • Search keywordkeywordObligatoriostring
    Google search keyword to collect. Each task accepts one keyword from 1 to 512 characters.
    Ejemplocartier
  • Expected result countcrawl_numObligatoriointeger
    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.
    Rango1–200Ejemplo1
  • Required wordsall_these_wordsOpcionalstring
    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_wordsOpcionalstring
    Candidate words of which at least one should appear. Separate multiple words with spaces. Leave empty to omit this filter.
  • Excluded wordsnone_of_these_wordsOpcionalstring
    Words that must not appear in the result. Separate multiple words with spaces. Leave empty to omit this filter.
  • Exact phrasethis_exact_word_or_phraseOpcionalstring
    Exact word or phrase that must appear as a whole. Leave empty to omit this filter.
  • Number rangenumbers_ranging_fromOpcionalstring
    Number range to keep in the results, such as 2024..2026. Leave empty to omit this filter.
  • File typefile_typeOpcionalstring
    Keep only results of this file type, such as Adobe Acrobat PDF (.pdf). Leave empty to omit this filter.
  • Interface languageinterface_languageOpcionalstring
    Google interface language, such as English. Leave empty to omit this filter.
  • Result languagesearch_languageOpcionalstring
    Language of the search results, such as English. Leave empty to omit this filter.
  • Last updatelast_updateOpcionalstring
    Last-update filter value, such as w. Leave empty to omit this filter.
  • Search typeorder_typeOpcionalstring
    Search type value, such as ALL. Leave empty to omit this filter.
  • RegionregionOpcionalstring
    Restrict results to a region, such as United States. Leave empty to omit this filter.
  • Site or domainsite_or_domainOpcionalstring
    Restrict the search to a site or domain, such as instagram.com. Leave empty to omit this filter.
  • Start datestart_dateOpcionalstring
    Start of the date range in YYYY-MM-DD. Leave empty to omit this filter.
  • End dateend_dateOpcionalstring
    End of the date range in YYYY-MM-DD. Leave empty to omit this filter.
  • Keyword locationterms_appearingOpcionalstring
    Where the keyword should appear, such as anywhere in the page. Leave empty to omit this filter.
  • Usage rightsusage_rightsOpcionalstring
    Usage-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 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

Datos de ejemplo

Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.

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
}

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 config
{
  "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

10 returned records

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.

0,006 US$/ 10 registros
Per task submitted

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,0001 US$/ ejecución

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éditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo
Los parámetros se validan contra input.schema antes del envío
Desde 0,006 US$ / 10 registros