Ads
Rechercher intérêts, lieux et langues sur Meta Ads et Google Ads via l'API
Une route résout un terme en ids attendus par le ciblage d'un ensemble d'annonces, pour que vous n'ayez pas à connaître l'id à l'avance. Elle fonctionne pour les intérêts, lieux et comportements, avec le compte du client connecté et sans app review Meta.
L'appel
GET /api/ads/targeting/search?customer_integration=<connection uuid>&type=interest&q=running&limit=10 Authorization: Bearer <merchant token> x-customer-token: <customer token>
Ce que vous pouvez faire
- Rechercher des intérêts par terme avec type=interest et utiliser l'id dans targeting.interests.
- Rechercher des lieux avec type=geo, en filtrant par pays avec country_code.
- Parcourir tous les comportements avec type=behavior, sans besoin de q.
- Voir la taille d'audience estimée dans audience_size, sous forme de fourchette de lower à upper.
- Limiter le nombre de résultats avec limit, de 1 à 200.
- Sur Google Ads, chercher des lieux avec type=geo (subtype est le type de lieu et path son nom complet) et des langues avec type=language, les deux avec q.
Règles et limites
- q est obligatoire pour interest et geo. Seul behavior liste tout sans terme, et country_code n'a d'effet que sur geo.
- Chaque résultat a le même format pour les trois types, avec id, name, type, subtype, path, description, country_code et audience_size. Pour geo, l'id est la clé du lieu.
- interest et behavior vont dans targeting.interests. Pour geo, seul un pays tient dans targeting.countries : ville, région et quartier passent par facebook_ads.targeting.raw.geo_locations, et le subtype indique lequel.
- La réponse n'est pas paginée : 200 éléments maximum par recherche.
- Cache de 600 s par connexion. meta.cached et meta.cached_at indiquent si cela vient du cache, et refresh=true l'ignore.
- Sur Google Ads, type n'accepte que geo et language, et l'id est la constante de lieu ou de langue de Google.
- Sur Google Ads, les résultats n'alimentent pas encore la création : campagne et groupe sont créés sans ciblage de lieu, de langue ni d'audience.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| customer_integration | string | Oui | L'uuid de la connexion du client. Il définit le compte publicitaire. Toujours dans la query. |
| type | string | Oui | Que chercher : interest, geo ou behavior. Sur Google Ads : geo ou language. |
| q | string | Non | Le terme recherché. Obligatoire pour interest et geo. behavior liste tout sans q. |
| country_code | string | Non | Code pays à 2 lettres. N'a d'effet que sur geo. |
| limit | integer | Non | Nombre maximum de résultats, de 1 à 200. |
| refresh | boolean | Non | Ignore le cache de 600 s et interroge à nouveau la plateforme. |
| subtype | string | Non | Dans la réponse, geo uniquement : country, region, city, neighborhood ou zip. Indique dans quel champ le résultat va. |
| audience_size | object | Non | Dans la réponse : la fourchette estimée de personnes (lower et upper). C'est une fourchette, et geo n'en a pas. |
Pour qui
Sélecteur d'audience dans votre SaaS
Vous saisissez un terme, affichez les intérêts avec la taille d'audience et construisez l'ensemble d'annonces avec les ids choisis.
Ciblage par ville
Une agence recherche la ville du client avec type=geo, lit le subtype et place l'id au bon endroit du ciblage.
Agent IA qui construit des audiences
Un agent reçoit "les gens qui aiment courir", recherche l'intérêt, choisit le résultat le plus proche et crée l'ensemble.
Fonctionne avec
Meta Ads
Google Ads
Questions fréquentes
Dois-je connaître l'id de l'intérêt à l'avance ?
Non. Cette route existe pour cela : vous cherchez le terme avec type=interest et q, et recevez l'id attendu par le ciblage.
Peut-on cibler par ville ?
Oui, mais ville, région et quartier ne vont pas dans targeting.countries. Ils passent par facebook_ads.targeting.raw.geo_locations, et le subtype du résultat indique lequel. Seul un pays va dans targeting.countries.
La recherche est-elle paginée ?
Non. 200 éléments maximum par recherche, contrôlés par limit. Affinez le terme si vous avez besoin de plus de précision.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
