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

# Ads

> Verwalten Sie beworbene Anzeigen über die Ayrshare-GraphQL-API mit einem einzigen Satz von Operationen, die die Ads-Plattform als Argument erhalten.

Die Ads-Operationen erhalten die Ads-Plattform als Argument, sodass dieselbe Operation auf jeder von Ayrshare unterstützten Ads-Plattform funktioniert. Aktuell sind das `FACEBOOK` und `INSTAGRAM`.

Jede Operation ruft den passenden [REST-Ads-Endpunkt](/docs/apis/ads/overview) auf und gibt dessen Antwort unverändert zurück. Authentifizierung und Limits sind dieselben wie bei REST. Ein fehlgeschlagener Aufruf gibt einen GraphQL-Fehler zurück: `extensions.status` enthält den REST-Status und `extensions.code` den Ayrshare-Fehlercode, sofern der REST-Fehler einen hat. Siehe [Fehler](/docs/apis/graphql/errors). Ads-Operationen erfordern das Ads-Add-on. Ohne dieses gibt jeder Aufruf einen Fehler mit `extensions.status` `403` und `extensions.code` `399` zurück.

<h2 id="operations">
  Operationen
</h2>

| Operation | Typ | REST-Endpunkt |
| - | - | - |
| `adAccounts` | Query | `GET /ads/{platform}/accounts` |
| `adTargetingSearch` | Query | `GET /ads/{platform}/interests`, `/regions` oder `/cities` |
| `ads` | Query | `GET /ads/{platform}/ads` |
| `adHistory` | Query | `GET /ads/{platform}/history` |
| `updateAd` | Mutation | `PUT /ads/{platform}/ads` |

Jede Operation akzeptiert außerdem ein optionales `profileKey`, um auf ein User Profile (Benutzerprofil) zu wirken. Alle geben die REST-Antwort als JSON zurück und erlauben daher keine Feldauswahl.

<h2 id="list-ad-accounts">
  Werbekonten auflisten
</h2>

Beginnen Sie hier. Verwenden Sie die `accountId`-Werte aus der Antwort überall dort, wo eine Operation nach `accountId` fragt.

```graphql theme={"system"}
query {
  adAccounts(platform: FACEBOOK, limit: 10)
}
```

<h2 id="search-targeting-options">
  Targeting-Optionen suchen
</h2>

`kind` legt die Suche fest: `INTERESTS` für das Zielgruppen-Targeting, `REGIONS` oder `CITIES` für Standorte. Jede Art akzeptiert nur ihre eigenen Argumente. So funktionieren `countryCode` und `regionId` beispielsweise nur mit `CITIES`, und `INTERESTS` erfordert `search`.

```graphql theme={"system"}
query {
  adTargetingSearch(platform: INSTAGRAM, kind: INTERESTS, search: "running")
}
```

```graphql theme={"system"}
query {
  adTargetingSearch(platform: FACEBOOK, kind: CITIES, search: "Austin", countryCode: "US")
}
```

<h2 id="list-ads">
  Anzeigen auflisten
</h2>

Übergeben Sie mindestens eines der Argumente `campaignId`, `accountId`, `adId`, `postId` oder `socialPostId`. `socialPostId` ist die eigene Beitrags-ID des Netzwerks, für Beiträge, die nicht über Ayrshare veröffentlicht wurden.

```graphql theme={"system"}
query {
  ads(platform: FACEBOOK, accountId: "act_1234567890")
}
```

<h2 id="see-what-an-ad-has-cost">
  Sehen, was eine Anzeige gekostet hat
</h2>

```graphql theme={"system"}
query {
  adHistory(platform: FACEBOOK, startDate: "2026-09-01", endDate: "2026-09-30")
}
```

<h2 id="pause-or-resume-an-ad">
  Eine Anzeige pausieren oder fortsetzen
</h2>

`updateAd` verändert echte Werbeausgaben. `PAUSED` stoppt die Ausgaben, `ACTIVE` setzt sie fort, und `DELETED` oder `ARCHIVED` beendet die Anzeige endgültig. Derselbe Status wird auch für die Anzeigengruppe und die Kampagne der Anzeige gesetzt, sodass sich alle anderen Anzeigen in dieser Anzeigengruppe oder Kampagne ebenfalls ändern.

```graphql theme={"system"}
mutation {
  updateAd(platform: FACEBOOK, adId: "120210000000000000", status: PAUSED)
}
```

<Note>
  Das Bewerben eines Beitrags über diese Operationen ist in Vorbereitung. Bis dahin verwenden Sie `boostFacebookPost` oder `instagramBoostPost` oder den REST-Boost-Endpunkt für [Facebook](/docs/apis/ads/facebook/boost-post) bzw. [Instagram](/docs/apis/ads/instagram/boost-post).
</Note>

Die plattformspezifischen Operationen wie `facebookAdAccounts` und `instagramAds` funktionieren weiterhin und sind unverändert.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.