> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Toppie

> Integra con Toppie programáticamente usando nuestra API

export const IntegrationsCard1AEs = () => {
  return <>
      <style>{`
        .integrations-card-1a-es {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a-es:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-es {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a-es:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-es-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: wrap;
        }

        .integrations-card-1a-es-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-es-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-es h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a-es h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-es-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-es-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a-es p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a-es p {
          color: #d1d5db;
        }

        .integrations-card-1a-es a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a-es a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a-es a {
          color: #8280ff;
        }

        .dark .integrations-card-1a-es a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-es-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-es-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a-es p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a-es h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-es-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-es">
        <div className="integrations-card-1a-es-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/gui.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/linn.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/max.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="" loading="lazy" className="integrations-card-1a-es-avatar" />
        </div>

        <h2>¿Necesitas ayuda con tu integración de Topsort?</h2>

        <p className="integrations-card-1a-es-subtitle">
          Habla con nosotros, el equipo de ingeniería de integraciones.
        </p>

        <p>
          Contáctanos a través de <strong>tu canal de mensajería dedicado</strong> o en{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Si aún no eres cliente,{" "}
          <a href="https://www.topsort.com/book-a-demo">agenda una demo</a> con nuestro
          equipo de ventas.
        </p>
      </div>
    </>;
};

<Note>
  La API de Toppie permite el acceso programático seguro a la plataforma unificada de retail media de Topsort. Ya sea que estés automatizando la gestión de campañas, creando dashboards personalizados o integrando datos de Toppie en flujos de trabajo existentes, la API proporciona la base para escalar operaciones de retail media más allá de la interfaz de usuario.
</Note>

La API de Toppie proporciona endpoints públicos para gestionar y analizar cuentas de agencia, campañas y actividad financiera en múltiples socios minoristas.

<Card title="Referencia de la API de Toppie" icon="book" href="/es/api-reference/toppie-api/">
  Consulta la documentación completa de la API con todos los endpoints disponibles
</Card>

## Beneficios Clave

* **Automatizar Operaciones de Campaña** - Crea flujos de trabajo para gestionar campañas en minoristas sin intervención manual
* **Integraciones Personalizadas** - Conecta datos de Toppie a herramientas de BI y sistemas internos
* **Control de Acceso Seguro** - Permisos basados en roles para datos y capacidades

## Capacidades de la API

La API de Toppie proporciona funcionalidad completa a través de los siguientes endpoints:

<AccordionGroup>
  <Accordion title="Gestión de Catálogo de Productos" icon="box">
    Carga, actualiza y gestiona catálogos de productos en socios minoristas. Mantén el inventario sincronizado y asegura información precisa de productos para tus campañas.
  </Accordion>

  <Accordion title="Operaciones de Ciclo de Vida de Campaña" icon="rectangle-ad">
    Crea, modifica, pausa y elimina campañas programáticamente. Establece presupuestos, parámetros de targeting y estrategias de puja para Listings Patrocinados y Banners.
  </Accordion>

  <Accordion title="Análisis Avanzado y Reportes" icon="chart-line">
    Recupera datos de rendimiento en tiempo real incluyendo impresiones, clics, conversiones, métricas de ROAS y gasto publicitario. Genera reportes personalizados con rangos de fechas y selecciones de métricas específicas.
  </Accordion>

  <Accordion title="Gestión de Presupuesto y Pujas" icon="dollar-sign">
    Rastrea saldos de cuenta, visualiza historial de transacciones y gestiona la facturación programáticamente. Implementa algoritmos personalizados de asignación de presupuesto basados en métricas de rendimiento.
  </Accordion>
</AccordionGroup>

## Autenticación

Todas las solicitudes de la API de Toppie requieren autenticación usando claves de API con autenticación basada en tokens. Esto garantiza un acceso seguro a tus campañas y datos.

### Obtener tu Clave de API

<Steps>
  <Step title="Navegar a Configuración">
    Accede a **Configuración** en la navegación de tu dashboard de Toppie
  </Step>

  <Step title="Seleccionar Integración de API">
    Elige **Integración de API** del menú de navegación izquierdo
  </Step>

  <Step title="Crear Nueva Clave">
    Haz clic en el botón **"+ Nueva Clave de API"** para generar una nueva clave
  </Step>

  <Step title="Guardar Inmediatamente">
    <Warning>
      Copia y guarda tu clave de API inmediatamente—solo se mostrará una vez por razones de seguridad
    </Warning>
  </Step>
</Steps>

### Usar tu Clave de API

Incluye tu clave de API en el encabezado `Authorization` de cada solicitud:

```bash theme={null}
curl -X GET "https://api.topsort.com/toppie/v1/campaigns" \
  -H "Authorization: Bearer TU_CLAVE_API" \
  -H "Content-Type: application/json"
```

### Mejores Prácticas de Seguridad

<Warning>
  **Pautas de Seguridad:**

  * Nunca compartas claves de API en repositorios de código o canales públicos
  * Rota las claves regularmente para mayor seguridad
  * Usa variables de entorno o bóvedas seguras para almacenar claves
  * Monitorea el uso de la API para detectar actividad inusual
  * Implementa controles de acceso apropiados en tus aplicaciones
</Warning>

## Casos de Uso Comunes

<Tabs>
  <Tab title="Automatización de Campañas">
    Automatiza la creación de campañas, ajustes de presupuesto y optimización de rendimiento basados en reglas y desencadenadores predefinidos. Crea flujos de trabajo que respondan a umbrales de rendimiento o condiciones del mercado.

    **Escenarios de ejemplo:**

    * Pausar automáticamente campañas cuando el ROAS cae por debajo del objetivo
    * Crear nuevas campañas basadas en actualizaciones del catálogo de productos
    * Ajustar pujas dinámicamente según la hora del día o niveles de inventario
  </Tab>

  <Tab title="Integración de Reportes">
    Extrae datos de rendimiento de Toppie a herramientas de business intelligence existentes o dashboards personalizados para reportes unificados en todos los canales de marketing.

    **Escenarios de ejemplo:**

    * Sincronizar métricas de campaña diarias a Google Sheets o Excel
    * Alimentar datos en dashboards de Tableau, Looker o Power BI
    * Agregar rendimiento de retail media con otros canales de marketing
  </Tab>

  <Tab title="Gestión de Inventario">
    Sincroniza catálogos de productos automáticamente y mantén el inventario actualizado en todos los socios minoristas, asegurando que las campañas siempre promuevan productos disponibles.

    **Escenarios de ejemplo:**

    * Sincronizar disponibilidad de productos desde tu sistema PIM
    * Actualizar precios y promociones en todas las campañas
    * Eliminar productos agotados de campañas activas
  </Tab>

  <Tab title="Optimización de Presupuesto">
    Implementa algoritmos personalizados de asignación de presupuesto basados en métricas de rendimiento y objetivos comerciales para maximizar retornos en socios minoristas.

    **Escenarios de ejemplo:**

    * Reasignar presupuestos a minoristas de mejor rendimiento
    * Implementar algoritmos de ritmo personalizados
    * Coordinar gasto en múltiples campañas y minoristas
  </Tab>
</Tabs>

## Documentación de la API

Para documentación completa de referencia de la API incluyendo especificaciones de endpoints, parámetros, ejemplos de solicitud/respuesta y pautas de manejo de errores, visita la [Referencia de la API de Toppie](/es/api-reference/toppie-api/).

<IntegrationsCard1AEs />