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

# Annonces

> Gérez les annonces sponsorisées via l'API GraphQL d'Ayrshare avec un seul ensemble d'opérations qui prend la plateforme publicitaire en argument.

Les opérations d'annonces prennent la plateforme publicitaire en argument : la même opération fonctionne donc sur toutes les plateformes publicitaires prises en charge par Ayrshare. Actuellement, il s'agit de `FACEBOOK` et `INSTAGRAM`.

Chaque opération appelle le [point de terminaison REST d'annonces](/docs/apis/ads/overview) correspondant et renvoie sa réponse telle quelle. L'authentification et les limites sont identiques à REST. Un appel en échec renvoie une erreur GraphQL : `extensions.status` contient le statut REST, et `extensions.code` le code d'erreur Ayrshare lorsque l'erreur REST en comporte un. Consultez [Erreurs](/docs/apis/graphql/errors). Les opérations d'annonces nécessitent le module complémentaire Ads. Sans lui, chaque appel renvoie une erreur avec `extensions.status` `403` et `extensions.code` `399`.

## Opérations

| Opération | Type | Point de terminaison REST |
| - | - | - |
| `adAccounts` | Query | `GET /ads/{platform}/accounts` |
| `adTargetingSearch` | Query | `GET /ads/{platform}/interests`, `/regions` ou `/cities` |
| `ads` | Query | `GET /ads/{platform}/ads` |
| `adHistory` | Query | `GET /ads/{platform}/history` |
| `updateAd` | Mutation | `PUT /ads/{platform}/ads` |

Chaque opération accepte également un `profileKey` facultatif pour agir sur un User Profile (profil utilisateur). Toutes renvoient la réponse REST sous forme de JSON : elles n'acceptent donc aucune sélection de champs.

## Lister les comptes publicitaires

Commencez ici. Utilisez les valeurs `accountId` de la réponse partout où une opération demande un `accountId`.

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

## Rechercher des options de ciblage

`kind` détermine la recherche : `INTERESTS` pour le ciblage d'audience, `REGIONS` ou `CITIES` pour les zones géographiques. Chaque type n'accepte que ses propres arguments. Par exemple, `countryCode` et `regionId` ne fonctionnent qu'avec `CITIES`, et `INTERESTS` nécessite `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")
}
```

## Lister les annonces

Transmettez au moins l'un des arguments `campaignId`, `accountId`, `adId`, `postId` ou `socialPostId`. `socialPostId` est l'identifiant de publication propre au réseau, pour les publications qui n'ont pas été publiées via Ayrshare.

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

## Voir ce qu'une annonce a coûté

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

## Mettre en pause ou réactiver une annonce

`updateAd` modifie des dépenses publicitaires réelles. `PAUSED` arrête les dépenses, `ACTIVE` les reprend, et `DELETED` ou `ARCHIVED` retire l'annonce. Le même statut est également appliqué à l'ensemble d'annonces et à la campagne de l'annonce : toutes les autres annonces de cet ensemble d'annonces ou de cette campagne sont donc modifiées en même temps.

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

<Note>
  La sponsorisation d'une publication via ces opérations arrive bientôt. D'ici là, utilisez `boostFacebookPost` ou `instagramBoostPost`, ou le point de terminaison REST de sponsorisation pour [Facebook](/docs/apis/ads/facebook/boost-post) ou [Instagram](/docs/apis/ads/instagram/boost-post).
</Note>

Les opérations propres à chaque plateforme, comme `facebookAdAccounts` et `instagramAds`, fonctionnent toujours et restent inchangées.


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