Google Trends Trending Now
Búsquedas en tendencia ahora en Google Trends para un país (EE. UU. por defecto) en las últimas 24 horas.
Consulta cada endpoint con ejemplos de solicitud, parámetros y su precio por solicitud. Una sola clave API los llama todos; se aplican límites de cuenta.
En resumen
- Endpoint
- POST https://api.serpbase.dev/google/trends/trending
- Precio
- 2 créditos / solicitud
- Autenticación
- X-API-Key
- Tipo de resultado
- schemas.source_data
Endpoint y reglas de facturación
https://api.serpbase.dev/google/trends/trendingCada solicitud usa el precio fijo del catálogo, no una tarifa por página. Web Crawl y User Agent cuestan actualmente 1 crédito por solicitud cada uno; User Agent no es gratuito. La ausencia real confirmada por la fuente y la identidad del recurso se cobra. no_results, HTTP 404 o la falta de hydration/datos analizados por sí solos no prueban ausencia. Los fallos ejecutados pueden consumir créditos; no se garantiza el reembolso de todos los fallos. credits_charged informa del cargo real: 0 indica cero; null o ausencia significa desconocido. charge_status UNKNOWN sigue siendo desconocido incluso con un valor numérico. Revisa los registros y contacta con soporte con request_id; no supongas un reembolso ni reintentes a ciegas.
Ejemplos de parámetros
Los ejemplos no son una lista completa ni reglas obligatorias. Se validan campos conocidos y se permiten parámetros adicionales.
| Parámetro | Tipo de ejemplo | Valor de ejemplo |
|---|---|---|
| gl | string | "us" |
{
"gl": "us"
}| Alias | Parámetro | Tipo |
|---|---|---|
| country | locale.country | string |
| cursor | pagination.cursor | string |
| device | options.device | string |
| geo | attributes.geo | string |
| gl | locale.country | string |
| google_domain | locale.engine_domain | string |
| gooogle_domain | locale.engine_domain | string |
| hl | locale.language | string |
| hours | attributes.hours | string |
| html | include_html | boolean |
| language | locale.language | string |
| limit | pagination.limit | integer |
| markdown | include_markdown | boolean |
| mobile | options.device | boolean |
| num | pagination.limit | integer |
| page | pagination.page | integer |
| q | query | string |
| results | pagination.limit | integer |
Dispositivos: desktop; predeterminado: desktop.
Ejemplos de solicitudes
curl -X POST 'https://api.serpbase.dev/google/trends/trending' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"gl":"us"}'const response = await fetch("https://api.serpbase.dev/google/trends/trending", {
"method": "POST",
"headers": {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
},
"body": "{\"gl\":\"us\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);Respuesta y resultado de la API
Las respuestas son JSON. HTTP 200 no prueba el éxito: revisa status y error. Los campos dependen del contrato y los datos de origen.
Ver documentación de respuestaPreguntas frecuentes
¿Cuánto cuesta la API de Google Trends Trending Now?
Cada solicitud cuesta 2 créditos. Los créditos se compran en paquetes prepago o con el plan mensual, y las cuentas nuevas empiezan con créditos gratis.
¿Cómo llamo a la API de Google Trends Trending Now?
Envía una solicitud POST a https://api.serpbase.dev/google/trends/trending con tu clave API en la cabecera X-API-Key. La respuesta es JSON; revisa status (0 significa éxito).
¿Qué dispositivos admite?
Dispositivos admitidos: desktop. El predeterminado es desktop.
¿La API de Google Trends Trending Now ya está disponible?
Sí. Cualquier clave API activa puede llamarla.