CrawlForge
BúsquedaGoogle API5 credits

search_web

Búsqueda web programática impulsada por Google Custom Search API con filtrado avanzado, clasificación y metadatos de resultados. Ideal para automatizar investigaciones y el descubrimiento de contenido.

Casos de uso

Automatización de investigaciones

Automatice investigaciones buscando artículos académicos, noticias o documentación técnica

Descubrimiento de contenido

Encuentre contenido, blogs o recursos relevantes para la creación y curación de contenido

Monitoreo competitivo

Rastree menciones de su marca, productos o competidores en toda la web

Generación de leads

Encuentre clientes potenciales, socios u oportunidades según los criterios de búsqueda

Investigación de SEO

Analice los resultados de búsqueda para comprender los factores de clasificación y las estrategias de los competidores

Recopilación de datos

Recopile URLs para hacer scraping o análisis posteriores según las consultas de búsqueda

Endpoint

POST/api/v1/tools/search_web
Auth Required
2 req/s en el plan Free
5 credits

Parameters

NameTypeRequiredDefaultDescription
query
stringRequired-
Consulta de búsqueda (admite operadores avanzados)
Example: best web scraping tools 2025
limit
numberOptional10
Número de resultados a devolver (1-100)
Example: 25
timeRange
stringOptional-
Filtrar por fecha de publicación: day, week, month, year o custom
Example: month
safeSearch
booleanOptionaltrue
Filtrar contenido explícito
Example: true
site
stringOptional-
Restringir la búsqueda a un sitio o dominio específico
Example: github.com
fileType
stringOptional-
Filtrar por tipo de archivo: pdf, doc, xls, ppt, etc.
Example: pdf
language
stringOptionalen
Código de idioma (ISO 639-1)
Example: en
country
stringOptional-
Código de país para resultados geoespecíficos (ISO 3166-1)
Example: us

Ejemplos de solicitud

terminalBash

Ejemplo de respuesta

200 OK1,250ms
{
  "success": true,
  "data": {
    "query": "best web scraping tools 2025",
    "totalResults": 12500000,
    "resultsReturned": 25,
    "results": [
      {
        "position": 1,
        "title": "Top 10 Web Scraping Tools for 2025 - Developer Guide",
        "url": "https://example.com/scraping-tools",
        "displayUrl": "example.com › scraping-tools",
        "snippet": "Discover the best web scraping tools in 2025 including CrawlForge MCP, Beautiful Soup, and Scrapy. Compare features, pricing, and use cases...",
        "date": "2025-09-15",
        "domain": "example.com",
        "favicon": "https://example.com/favicon.ico"
      },
      {
        "position": 2,
        "title": "CrawlForge MCP: The Ultimate Web Scraping Solution",
        "url": "https://crawlforge.dev",
        "displayUrl": "crawlforge.dev",
        "snippet": "CrawlForge MCP offers 23 powerful web scraping tools in one API. Start with 1,000 free credits and automate your data extraction...",
        "date": "2025-09-28",
        "domain": "crawlforge.dev",
        "favicon": "https://crawlforge.dev/favicon.ico"
      }
    ],
    "searchMetadata": {
      "searchTime": 0.45,
      "language": "en",
      "country": "us",
      "safeSearch": true,
      "timeRange": "month"
    }
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1250
}
Field Descriptions
data.totalResultsTotal de resultados disponibles (no todos se devuelven)
data.resultsReturnedNúmero de resultados en esta respuesta
data.resultsArreglo de resultados de búsqueda con metadatos
data.results[].snippetExtracto descriptivo de la página
data.results[].dateFecha de publicación si está disponible
credits_used5 credits fijos por consulta de búsqueda
processing_timeLa búsqueda normalmente se completa en 1-2 segundos

Manejo de errores

Consulta vacía (400 Bad Request)

La consulta de búsqueda no puede estar vacía. Proporcione al menos 2 caracteres.

No se encontraron resultados (404 Not Found)

Ningún resultado de búsqueda coincide con su consulta. Pruebe términos de búsqueda más amplios o quite los filtros.

Parámetros no válidos (400 Bad Request)

Verifique los parámetros timeRange, language o country en busca de valores válidos.

Cuota excedida (429 Too Many Requests)

La API de búsqueda tiene límites diarios. Actualice su plan para obtener cuotas más altas.

Consejo profesional: Use operadores de búsqueda como site:, filetype: o intitle: en su consulta para obtener resultados más precisos. Ejemplo: "site:github.com web scraping" devuelve solo resultados de GitHub.

Costo en credits

5 credits
5 credits por búsqueda
Costo fijo independientemente del número de resultados. Los credits se cobran solo por las búsquedas exitosas.

Qué incluye:

Hasta 100 resultados por búsqueda

Filtrado avanzado (tiempo, sitio, tipo de archivo)

Soporte para múltiples idiomas y países

Filtrado de búsqueda segura

Metadatos de resultados (fecha, dominio, fragmento)

Recomendaciones de 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

deep_research
Investigación multietapa con análisis de IA (10 credits)
batch_scrape
Haga scraping de URLs de resultados de búsqueda en paralelo (1 credit por URL)
analyze_content
Analice resultados de búsqueda en busca de sentimiento y temas (3 credits)
extract_content
Extraiga el contenido principal de los resultados de búsqueda (2 credits)
¿Listo para probar search_web? Regístrese gratis y obtenga 1,000 credits para empezar a desarrollar.