BúsquedaGoogle API5 credits

search_web

El índice de Google, en JSON. Cada resultado incluye el título, la URL, el fragmento y las variantes resaltadas del propio Google, junto con un bloque de metadatos con el total de coincidencias y el tiempo que tardó la búsqueda. Los filtros de sitio, tipo de archivo, idioma, actualidad y búsqueda segura se aplican como operadores reales de Google.

Casos de uso

Pipelines de investigación

Encuentre fuentes sobre un tema y pase las URL directamente a batch_scrape o extract_content.

Búsqueda acotada a un sitio

Use site para buscar dentro de un único dominio: un sustituto del buscador interno cuando no existe o funciona mal.

Búsqueda de documentos

Combine file_type con una consulta para encontrar PDF, hojas de cálculo o presentaciones sobre un tema.

Seguimiento de novedades

Limite al último día o a la última semana con time_range para detectar nuevas menciones de un tema o una marca.

Descubrimiento competitivo

Vea qué páginas muestra Google para los términos que le interesan y cuántos resultados hay en total.

Anclaje de agentes

Dé a un modelo resultados de búsqueda actuales con los que trabajar, en lugar de depender de lo que memorizó.

Endpoint

POST/api/v1/tools/search_web

Auth Required

1 req/s en el plan Free

5 credits

Parameters

limit admite hasta 100, pero Google devuelve como máximo 10 resultados por solicitud: un limit mayor no falla, simplemente le da 10. Recorra el resto con offset, una búsqueda (y 5 credits) por página.

Name	Type	Required	Default	Description
query	string	Required	-	Los términos de búsqueda. Los operadores de Google que escriba aquí funcionan igual que en el cuadro de búsqueda, y `site` y `file_type` se añaden como operadores adicionales. Example: mcp server for web scraping
limit	number	Optional	10	Resultados que devolver, de 1 a 100, pero Google limita cada solicitud a 10, así que cualquier valor por encima de 10 se comporta como 10. Example: 10
offset	number	Optional	0	Índice de base cero del primer resultado. Use 10, 20, 30 para paginar. Cada página es una búsqueda aparte y cuesta 5 credits. Example: 10
lang	string	Optional	-	Limita a documentos en un solo idioma, con un código ISO 639-1. Se devuelve en `search_metadata.lang`, que toma `en` por defecto si lo omite. Example: es
site	string	Optional	-	Limita a un dominio. Se añade a su consulta como `site:<dominio>`, así que se comporta igual que si lo escribiera. Example: docs.anthropic.com
safe_search	boolean	Optional	-	Activa el filtrado SafeSearch de Google. Desactivado salvo que lo indique. Example: true
time_range	string	Optional	-	Limita por actualidad: `day`, `week`, `month`, `year` o `all`. `all` no aplica ninguna restricción, y es además el valor por defecto. Example: week
file_type	string	Optional	-	Limita a una única extensión de archivo. Se añade como `filetype:<ext>`, así que `pdf`, `xlsx` y `pptx` funcionan. Example: pdf

Ejemplos de solicitud

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/search_web \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mcp server for web scraping",
    "limit": 10,
    "time_range": "month",
    "safe_search": true
  }'

Ejemplo de respuesta

200 OK460ms

{
  "success": true,
  "data": {
    "query": "mcp server for web scraping",
    "search_metadata": {
      "total_results": 48200,
      "results_returned": 1,
      "offset": 0,
      "search_time": 0.312,
      "lang": "en",
      "safe_search": false,
      "time_range": "month",
      "site": null,
      "file_type": null
    },
    "results": [
      {
        "title": "CrawlForge MCP Server — 29 web tools for Claude",
        "url": "https://www.crawlforge.dev/",
        "snippet": "Search, scrape, crawl and extract from any site through one MCP server.",
        "displayLink": "www.crawlforge.dev",
        "formattedUrl": "https://www.crawlforge.dev/",
        "htmlSnippet": "Search, scrape, crawl and extract from any site through one MCP server.",
        "htmlTitle": "CrawlForge MCP Server — 29 web tools for Claude",
        "cacheId": "x8Kd0PqR2mUJ",
        "pagemap": {
          "metatags": [
            {
              "og:type": "website"
            }
          ]
        }
      }
    ],
    "spelling_correction": "mcp server for web scraping",
    "related_searches": [
      "mcp web scraping tools",
      "model context protocol scraper"
    ]
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 460
}

Field Descriptions

data.queryLos términos que Google buscó realmente, que pueden diferir de los que envió

data.search_metadata.total_resultsLa estimación de Google de documentos coincidentes. Es una estimación, no un recuento que pueda recorrer paginando

data.search_metadata.results_returnedLongitud de `results`: como máximo 10

data.search_metadata.search_timeSegundos que empleó Google, según lo informa el propio Google. No es la latencia de su solicitud

data.results[].urlEl enlace de destino. `formattedUrl` es la versión de visualización que Google hace de la misma dirección

data.results[].htmlSnippetEl fragmento conservando el resaltado `<b>` de los términos que añade Google. Escápelo antes de renderizarlo

data.results[].cacheIdEl identificador de caché de Google, cuando existe. No aparece en resultados que Google no ha cacheado

data.results[].pagemapDatos estructurados que Google extrajo de la página: metaetiquetas, imágenes, tipos de schema.org. Su forma varía en cada resultado y puede no aparecer

data.spelling_correctionLa corrección ortográfica sugerida por Google, o `null` cuando no hay ninguna

data.related_searchesSugerencias de consultas relacionadas. A menudo es un array vacío

credits_used5 credits fijos por búsqueda, sea cual sea el `limit` que haya pedido

Manejo de errores

Consulta no válida (400 Bad Request)

VALIDATION_ERROR. query es obligatorio y no puede estar vacío. El mismo estado cubre un limit fuera de 1-100, un offset negativo o un time_range que no sea uno de los cinco valores aceptados.

La búsqueda falló (500 Internal Server Error)

TOOL_ERROR. Cubre un error de Google, una cuota diaria agotada y un tiempo de espera de 10 segundos. El mensaje indica la causa. Una búsqueda fallida no se cobra.

Nota: Una búsqueda sin coincidencias devuelve 200 con un array results vacío y total_results: 0, no un error. Compruebe results_returned en lugar de fiarse del código de estado.

Costo en credits

5 credits

5 credits por búsqueda

Una búsqueda es un cargo, devuelva 10 resultados o ninguno. Paginar con offset implica otra búsqueda, así que diez páginas cuestan 50 credits. Las búsquedas fallidas no se cobran.

Qué incluye:

El índice en vivo de Google, no una copia cacheada

Título, URL, fragmento y las variantes resaltadas de Google

Estimación del total de coincidencias y tiempo de búsqueda

Filtros site, file_type, lang, time_range y de búsqueda segura

Corrección ortográfica y búsquedas relacionadas cuando Google las proporciona

Recomendaciones por plan:

Plan Free: 1,000 credits de prueba por única vez = 200 búsquedas

Plan Hobby: 5,000 credits = 1,000 búsquedas ($19/mo)

Plan Professional: 50,000 credits = 10,000 búsquedas ($99/mo)

Herramientas relacionadas

serp_rank

Posición orgánica exacta de un dominio para una consulta (5 credits)

reddit_search

Busque en Reddit, que bloquea el scraping directo (5 credits)

deep_research

Busque, lea y sintetice en una sola llamada (10 credits)

batch_scrape

Extraiga las URL que devolvió una búsqueda (5 credits por URL)

¿Listo para probar search_web? Regístrese gratis y obtenga 1,000 credits para empezar a crear.