Saltar al contenido

Data API de Capzy. Elige tu fuente.

Busca el endpoint de un sitio compatible, envía sus parámetros y recibe JSON. Consulta la referencia aquí y ejecuta las solicitudes en el playground del panel.

Búsqueda en Amazon, de un vistazo

Fuente + acciónGET /v1/amazon/search
Consultawireless earbuds
Campo de respuestaorganic_results · títulos, precios, ASINs

Ejemplo ilustrativo

Encuentra la fuente que necesitas

Cada fuente tiene sus propios endpoints, entradas obligatorias y forma de respuesta. Abre su referencia para comprobar la cobertura antes de crear una integración.

Todas las fuentes (83)

Tu primera solicitud de Data API

Este ejemplo de Amazon usa un endpoint GET específico de la fuente. HTTP 200 devuelve los datos de la fuente; HTTP 202 devuelve un estado pendiente y un jobId. Revisa los trabajos pendientes en la página Ejecuciones del panel de Data API antes de enviar otra solicitud.

  1. Crea una key de Data API

    Abre el panel de Data API para copiar tu key dedicada de Data API. Los créditos del plan se usan primero; el uso adicional se cobra del saldo compartido de tu cuenta de Capzy.

    Abrir Data API
  2. Elige la fuente y la acción

    Usa la referencia del sitio para encontrar el método, la ruta y los parámetros obligatorios. El ejemplo de búsqueda de Amazon envía query y domain a /v1/amazon/search.

    Leer los parámetros de búsqueda de Amazon
  3. Inspecciona el JSON en el playground

    Abre la fuente correspondiente en tu panel, selecciona la acción, completa sus entradas y ejecuta una solicitud. Comprueba el precio actual del endpoint antes de ejecutar.

    Abrir el playground de búsqueda de Amazon
amazon_search.py
# Install: pip install requests
import os
import requests

response = requests.get(
    "https://api.capzy.ai/v1/amazon/search",
    headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
    params={"query": "wireless earbuds", "domain": "com"},
    timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
    print("Pending:", data.get("status"), "Job:", data.get("jobId"))
    print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
    for item in data.get("organic_results", []):
        print(item["title"], item.get("price"))
    print("Credits used:", response.headers.get("X-Credits-Used"))

Conoce el contrato antes de llamar

La autenticación es común a todas las fuentes de Data API. Los métodos, parámetros y campos devueltos son propios de cada endpoint.

X-API-KeyObligatorio · header
Envía tu key dedicada de Data API en este header. Mantenla en el servidor y léela desde CAPZY_DATA_API_KEY en estos ejemplos.
/v1/{source}/{path}Específico del endpoint · ruta
Sigue el método y la ruta de la referencia de la fuente. Por ejemplo, GET /v1/amazon/search recibe query y domain como parámetros de consulta.
X-Credits-UsedHeader de respuesta
Consulta los créditos cobrados por la solicitud. Los precios de los endpoints y los descuentos del plan aparecen en el panel y en la referencia de la fuente.
X-Next-CursorHeader de respuesta · cuando está presente
Algunos endpoints devuelven un cursor para la página siguiente. Usa los parámetros de paginación de cada endpoint; no todas las fuentes usan el mismo modelo de paginación.

Usa los campos reales de la fuente

Una respuesta HTTP 200 de búsqueda en Amazon expone organic_results en el nivel superior. HTTP 202, en cambio, devuelve un envoltorio de estado con jobId; revísalo en la página Ejecuciones del panel. Esta respuesta exitosa abreviada usa datos de producto ilustrativos.

response.example.json
{
  "search_information": {
    "query": "wireless earbuds"
  },
  "organic_results": [
    {
      "title": "Example wireless earbuds",
      "price": "$27.99",
      "extracted_price": 27.99,
      "asin": "EXAMPLE001"
    }
  ]
}

organic_results · títulos, precios, ASINs

Parámetros

Precios

Los planes de Data API incluyen un cupo mensual de créditos. El uso adicional se cobra del saldo compartido de tu cuenta de Capzy. Consulta la referencia de la fuente para ver el precio actual en créditos del endpoint.

Cargando precios actuales…

Lo que conviene saber

¿Dónde se abre el playground?

En Panel → Data API → Scrapers. Los enlaces de fuente abren el configurador de esa fuente. Los enlaces de endpoint preseleccionan la acción correspondiente para que puedas revisar las entradas obligatorias antes de ejecutar.

¿Puedo usar mi API key del solver?

Usa la key dedicada de Data API que aparece en el panel de Data API. Data API tiene sus propios controles de plan y créditos incluidos, mientras que el uso adicional se paga con el saldo compartido de tu cuenta de Capzy.

¿Todas las fuentes devuelven el mismo JSON?

No. Cada endpoint tiene una forma de respuesta específica de la fuente. Revisa su respuesta documentada y gestiona los campos ausentes u opcionales en tu aplicación.

¿Y si un endpoint está marcado como próximamente?

El panel marca los endpoints que no están verificados ni disponibles para ejecutarse. Usa las acciones compatibles que aparecen ahí; una entrada en la referencia por sí sola no garantiza que un endpoint esté listo.

Encuentra una fuente. Prueba una solicitud.

El playground reúne los parámetros, la respuesta y los precios actuales.

Abrir playground