Del contenido al código.

Estado de la beta

El registro, la gestión de API keys y los endpoints están disponibles. La conexión de nuevas cuentas de Instagram está en preparación. Sin una cuenta conectada e indexada, el catálogo estará vacío. La búsqueda semántica requiere que los servicios de IA estén habilitados.

1. Crea una API key

Crea tu cuenta o inicia sesión y abre API keys. La clave completa se muestra una sola vez. Guárdala en el entorno de tu servidor y envíala en el encabezado Authorization: Bearer <key>.

No publiques la clave en repositorios ni la incluyas en JavaScript del navegador. Una clave permite acceder al catálogo de tu organización y puede revocarse desde el panel.

2. Consulta tus registros

curl "https://pixtorows.com/api/v1/items?limit=50" \
  -H "Authorization: Bearer $PIXTOROWS_API_KEY"

{
  "items": [],
  "nextCursor": null
}

Con contenido indexado, cada elemento incluye id, instagramId, permalink, postedAt, mediaType, analysis y contentText. Usa nextCursor como parámetro cursor para continuar. El límite predeterminado es 50 y el máximo es 200.

3. Exporta JSON o JSONL

curl "https://pixtorows.com/api/v1/export?format=jsonl" \
  -H "Authorization: Bearer $PIXTOROWS_API_KEY" \
  -o catalogo.jsonl

format=json devuelve un arreglo; format=jsonl emite un registro JSON por línea. El export incluye sólo elementos indexados, del más reciente al más antiguo; añade indexedAt a los campos del catálogo. Los datos originales completos de Meta y los identificadores internos de organización/cuenta no forman parte del export.

El límite actual es de cinco exportaciones por organización en cinco minutos en la instancia actual. Los errores durante la transmisión pueden interrumpir el archivo: verifica que la descarga termine antes de procesarla como completa.

Endpoints

Búsqueda semántica

curl "https://pixtorows.com/api/v1/search" \
  -H "Authorization: Bearer $PIXTOROWS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"tazas de cerámica en tonos tierra","limit":5}'

Devuelve results con pageContent, metadata y score. El texto de pageContent incluye el enlace a Instagram. La consulta se envía al proveedor de embeddings; revisa privacidad antes de incluir datos personales.

Errores y límites

• 401: clave ausente, inválida o revocada.
• 400: parámetros inválidos, como un formato de export o cursor incorrectos.
• 429: límite de exportación alcanzado; respeta Retry-After.

La versión actual procesa fotos y carruseles de cuentas profesionales autorizadas. No analiza vídeos/reels, no ofrece un lenguaje SQL y no importa mensajes privados. La sincronización continua, los SDK oficiales y otras funciones no descritas no forman parte del contrato actual.