Tendencias de Google

Disponibilidad: disponible

Este endpoint está activo en la gateway v1, OpenAPI y el catálogo de suscripciones. Una llamada correcta consume 1 unidad de facturación.

POST /v1/amazon/google/trends

Mapeo de la API

La ruta antigua /v1/amazon/keywords/google-trends se mantiene por compatibilidad y está obsoleta. Las solicitudes antiguas devuelven Deprecation: true y un encabezado Link hacia la ruta canónica.

Llamada rápida

Primero crea una API key y guárdala en una variable de entorno del servidor.

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/google/trends \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{"marketplace":"US"}'

Integración con un AI CLI

Pide a Codex, Claude Code o Cursor que lea esta página, use ECOMMERCE_DATA_API_KEY y realice únicamente la consulta aprobada. No pegues la clave en el prompt.

Ejemplos de integración

Node.js

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/google/trends',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({ marketplace: 'US' }),
  }
);
const result = await response.json();
if (!response.ok)
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
console.log(result.data);

Python

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/google/trends",
    headers={"Content-Type": "application/json", "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
    json={"marketplace": "US"},
    timeout=30,
)
response.raise_for_status()
print(response.json()["data"])

Cuerpo de la solicitud

Envía los campos directamente en el cuerpo JSON, sin un contenedor request.

Si se omite marketplace, se utiliza US salvo que el contrato del endpoint indique lo contrario.

Estructura de respuesta

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {}
}

request_id identifica la llamada. Los campos adicionales dentro de data siguen el contrato actual del endpoint y pueden variar según el marketplace y el periodo consultado.

Errores y límites

Comprueba error.code y error.message cuando la respuesta no sea 2xx. Conserva request_id al solicitar soporte y respeta los límites de frecuencia y las unidades de facturación de tu plan.