> ## 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.

# Toppie API

> Integrieren Sie Toppie programmatisch über unsere API

export const IntegrationsCard1ADe = () => {
  return <>
      <style>{`
        .integrations-card-1a-de {
          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-de:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-de {
          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-de:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

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

        .integrations-card-1a-de-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-de-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-de 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-de h2 {
          color: #f9fafb;
        }

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

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

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

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

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

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

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

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

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

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

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

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

          .integrations-card-1a-de-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-de">
        <div className="integrations-card-1a-de-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="Agustin - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="Amelia - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="Bernardita - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="Borumy - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="Felipe - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/gui.webp" alt="Gui - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="Javiera - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/linn.webp" alt="Linn - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="Marcio - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="Mateus - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/max.webp" alt="Max - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="Rodrigo - Integrations Team Member" loading="lazy" className="integrations-card-1a-de-avatar" />
        </div>

        <h2>Brauchen Sie Hilfe bei Ihrer Topsort-Integration?</h2>

        <p className="integrations-card-1a-de-subtitle">
          Sprechen Sie mit uns, dem Integrations-Engineering-Team.
        </p>

        <p>
          Erreichen Sie uns über <strong>Ihren dedizierten Nachrichtenkanal</strong> oder unter{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Falls Sie noch kein Kunde sind,{" "}
          <a href="https://www.topsort.com/book-a-demo">buchen Sie eine Demo</a> mit unserem
          Vertriebsteam.
        </p>
      </div>
    </>;
};

<Note>
  Die Toppie API ermöglicht sicheren programmatischen Zugriff auf die einheitliche Retail-Media-Plattform von Topsort. Ob Sie das Kampagnenmanagement automatisieren, benutzerdefinierte Dashboards erstellen oder Toppie-Daten in bestehende Workflows integrieren - die API bietet die Grundlage für die Skalierung von Retail-Media-Operationen über die Benutzeroberfläche hinaus.
</Note>

Die Toppie API bietet öffentliche Endpunkte zur Verwaltung und Analyse von Agenturkonten, Kampagnen und Finanzaktivitäten über mehrere Einzelhandelspartner hinweg.

<Card title="Toppie API-Referenz" icon="book" href="/de/api-reference/toppie-api/">
  Vollständige API-Dokumentation mit allen verfügbaren Endpunkten anzeigen
</Card>

## Hauptvorteile

* **Kampagnenoperationen automatisieren** - Erstellen Sie Workflows zur Verwaltung von Kampagnen über Einzelhändler hinweg ohne manuelle Eingriffe
* **Benutzerdefinierte Integrationen** - Verbinden Sie Toppie-Daten mit BI-Tools und internen Systemen
* **Sichere Zugriffskontrolle** - Rollenbasierte Berechtigungen für Daten und Funktionen

## API-Funktionen

Die Toppie API bietet umfassende Funktionalität über die folgenden Endpunkte:

<AccordionGroup>
  <Accordion title="Produktkatalog-Verwaltung" icon="box">
    Laden Sie Produktkataloge hoch, aktualisieren und verwalten Sie sie bei Einzelhandelspartnern. Halten Sie das Inventar synchron und stellen Sie genaue Produktinformationen für Ihre Kampagnen sicher.
  </Accordion>

  <Accordion title="Kampagnen-Lebenszyklus-Operationen" icon="rectangle-ad">
    Erstellen, ändern, pausieren und löschen Sie Kampagnen programmatisch. Legen Sie Budgets, Targeting-Parameter und Gebotsstrategien für Sponsored Listings und Banner fest.
  </Accordion>

  <Accordion title="Erweiterte Analyse und Berichterstattung" icon="chart-line">
    Rufen Sie Echtzeit-Leistungsdaten ab, einschließlich Impressionen, Klicks, Conversions, ROAS-Metriken und Werbeausgaben. Generieren Sie benutzerdefinierte Berichte mit spezifischen Datumsbereichen und Metrikauswahlen.
  </Accordion>

  <Accordion title="Budget- und Gebotsverwaltung" icon="dollar-sign">
    Verfolgen Sie Kontostände, sehen Sie Transaktionsverläufe ein und verwalten Sie die Abrechnung programmatisch. Implementieren Sie benutzerdefinierte Budgetzuteilungsalgorithmen basierend auf Leistungsmetriken.
  </Accordion>
</AccordionGroup>

## Authentifizierung

Alle Toppie API-Anfragen erfordern eine Authentifizierung mit API-Schlüsseln und tokenbasierter Authentifizierung. Dies gewährleistet sicheren Zugriff auf Ihre Kampagnen und Daten.

### Ihren API-Schlüssel erhalten

<Steps>
  <Step title="Zu Einstellungen navigieren">
    Greifen Sie auf **Einstellungen** in der Navigation Ihres Toppie-Dashboards zu
  </Step>

  <Step title="API-Integration auswählen">
    Wählen Sie **API-Integration** aus dem linken Navigationsmenü
  </Step>

  <Step title="Neuen Schlüssel erstellen">
    Klicken Sie auf die Schaltfläche **"+ Neuer API-Schlüssel"**, um einen neuen Schlüssel zu generieren
  </Step>

  <Step title="Sofort speichern">
    <Warning>
      Kopieren und speichern Sie Ihren API-Schlüssel sofort—er wird aus Sicherheitsgründen nur einmal angezeigt
    </Warning>
  </Step>
</Steps>

### Ihren API-Schlüssel verwenden

Fügen Sie Ihren API-Schlüssel in den `Authorization`-Header jeder Anfrage ein:

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

### Best Practices für Sicherheit

<Warning>
  **Sicherheitsrichtlinien:**

  * Teilen Sie API-Schlüssel niemals in Code-Repositories oder öffentlichen Kanälen
  * Rotieren Sie Schlüssel regelmäßig für erhöhte Sicherheit
  * Verwenden Sie Umgebungsvariablen oder sichere Tresore zum Speichern von Schlüsseln
  * Überwachen Sie die API-Nutzung auf ungewöhnliche Aktivitäten
  * Implementieren Sie geeignete Zugriffskontrollen in Ihren Anwendungen
</Warning>

## Häufige Anwendungsfälle

<Tabs>
  <Tab title="Kampagnenautomatisierung">
    Automatisieren Sie die Kampagnenerstellung, Budgetanpassungen und Leistungsoptimierung basierend auf vordefinierten Regeln und Auslösern. Erstellen Sie Workflows, die auf Leistungsschwellen oder Marktbedingungen reagieren.

    **Beispielszenarien:**

    * Kampagnen automatisch pausieren, wenn der ROAS unter das Ziel fällt
    * Neue Kampagnen basierend auf Produktkatalog-Updates erstellen
    * Gebote dynamisch anpassen basierend auf Tageszeit oder Lagerbeständen
  </Tab>

  <Tab title="Berichtsintegration">
    Ziehen Sie Toppie-Leistungsdaten in bestehende Business-Intelligence-Tools oder benutzerdefinierte Dashboards für einheitliche Berichterstattung über alle Marketingkanäle hinweg.

    **Beispielszenarien:**

    * Tägliche Kampagnenmetriken mit Google Sheets oder Excel synchronisieren
    * Daten in Tableau-, Looker- oder Power BI-Dashboards einspeisen
    * Retail-Media-Leistung mit anderen Marketingkanälen aggregieren
  </Tab>

  <Tab title="Bestandsverwaltung">
    Synchronisieren Sie Produktkataloge automatisch und halten Sie das Inventar bei allen Einzelhandelspartnern aktuell, um sicherzustellen, dass Kampagnen immer verfügbare Produkte bewerben.

    **Beispielszenarien:**

    * Produktverfügbarkeit aus Ihrem PIM-System synchronisieren
    * Preise und Aktionen in allen Kampagnen aktualisieren
    * Ausverkaufte Produkte aus aktiven Kampagnen entfernen
  </Tab>

  <Tab title="Budgetoptimierung">
    Implementieren Sie benutzerdefinierte Budgetzuteilungsalgorithmen basierend auf Leistungsmetriken und Geschäftszielen, um Erträge bei Einzelhandelspartnern zu maximieren.

    **Beispielszenarien:**

    * Budgets zu leistungsstärksten Einzelhändlern umverteilen
    * Benutzerdefinierte Pacing-Algorithmen implementieren
    * Ausgaben über mehrere Kampagnen und Einzelhändler hinweg koordinieren
  </Tab>
</Tabs>

## API-Dokumentation

Für vollständige API-Referenzdokumentation einschließlich Endpunktspezifikationen, Parametern, Anfrage-/Antwortbeispielen und Fehlerbehandlungsrichtlinien besuchen Sie die [Toppie API-Referenz](/de/api-reference/toppie-api/).

<IntegrationsCard1ADe />