Skip to main content
GET
Recherchez les centres d’intérêt de ciblage publicitaire Facebook disponibles par mot-clé. Utilisez cet endpoint pour rechercher les ID de centres d’intérêt à utiliser dans l’endpoint Boost Post. Cet endpoint vous aide à découvrir les options de ciblage basées sur les centres d’intérêt pour vos annonces Facebook, ainsi que des estimations de taille d’audience.
  • Les ID de centres d’intérêt peuvent être utilisés dans le tableau interests lors de la sponsorisation de publications.
  • Les résultats sont mis en cache pendant 10 minutes.
  • Utilisez des termes de recherche spécifiques et pertinents pour de meilleurs résultats.
  • Facebook peut renvoyer des résultats différents en fonction du secteur et de la région de votre compte publicitaire.
  • Les champs audienceSizeLowerBound et audienceSizeUpperBound dans la réponse JSON fournissent une plage estimée de la taille de l’audience pour le centre d’intérêt et sont utiles pour le ciblage.
  • Utilisez specialAdCategories pour ne renvoyer que les centres d’intérêt que Meta autorise pour une campagne de catégorie publicitaire spéciale. Les requêtes filtrées nécessitent également accountId.

Paramètres d’en-tête

Paramètres de requête

La requête de recherche pour récupérer les centres d’intérêt d’annonces Facebook.N’oubliez pas d’échapper la requête de recherche, par exemple Rhythm%20and%20blues%20music.
array
Restreignez les résultats aux centres d’intérêt que Meta autorise une campagne de catégorie publicitaire spéciale à cibler. Utilisez ce paramètre avant de sponsoriser une publication liée au logement, à l’emploi, à la finance ou à la politique afin de choisir des ID de centres d’intérêt pour lesquels l’annonce sera effectivement approuvée.Les valeurs suivantes sont prises en charge, correspondant au paramètre du même nom de Boost Post :
  • housing
  • employment
  • financial_product_services — financial_products_services et credit sont acceptés comme équivalents et correspondent à la même catégorie
  • issues_elections_politics
  • none — accepté par symétrie avec Boost Post, où il signifie « n’appartient à aucune catégorie publicitaire spéciale ». Il est envoyé à Meta sous la forme regulated_categories=["NONE"] : accountId est requis et une réponse réussie renvoie ["NONE"]. Cela ne garantit pas les mêmes résultats qu’une recherche non filtrée ; un rejet de Meta renvoie code: 368. Si vous voulez une recherche ordinaire non filtrée, omettez entièrement specialAdCategories plutôt que d’envoyer none.
Les valeurs sont insensibles à la casse. Une valeur non reconnue est rejetée avec un 400 et code: 101 listant les valeurs acceptées. Ce message est rédigé dans la forme majuscule de Meta et nomme aussi les graphies alternatives ci-dessus ; il se lit donc NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT — les mêmes catégories que celles listées ici, pas des catégories supplémentaires. Boost Post renvoie le même message. Une valeur vide, comme dans ?specialAdCategories=, est rejetée de la même manière.Transmettez plusieurs catégories en répétant le paramètre, par exemple ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. La forme avec crochets ?specialAdCategories[]=employment&specialAdCategories[]=housing fonctionne également. Une chaîne séparée par des virgules comme ?specialAdCategories=employment,housing n’est pas prise en charge et est rejetée avec un 400 et code: 101. Toutes les catégories demandées sont envoyées à Meta en une seule recherche. Ayrshare renvoie les résultats de Meta et ne calcule ni ne garantit une intersection de centres d’intérêt éligibles indépendamment. Répéter une catégorie, ou envoyer deux graphies de la même catégorie, est réduit à une seule catégorie.Lorsque vous fournissez plusieurs catégories, le champ specialAdCategories renvoyé dans la réponse est trié par ordre alphabétique plutôt que renvoyé dans l’ordre où vous l’avez envoyé.Omettez entièrement specialAdCategories et l’endpoint se comporte exactement comme avant : une recherche non filtrée, aucun accountId nécessaire, et la même forme de réponse.
string
Requis lorsque specialAdCategories est fourni, et ignoré sinon. L’ID du compte publicitaire Facebook pour lequel les centres d’intérêt sont recherchés, sans le préfixe act_ — la même valeur que celle acceptée par Boost Post. Récupérez-le depuis l’endpoint des comptes publicitaires. Il doit être numérique ; un act_ en tête est accepté et retiré, et toute autre valeur est rejetée avec un 400 et code: 101.
Meta ne propose la recherche de centres d’intérêt tenant compte de la catégorie que sur un compte publicitaire ; une requête qui fournit specialAdCategories sans accountId est donc rejetée avec un 400 et code: 101 avant toute recherche. Une requête sans specialAdCategories est inchangée et ne nécessite toujours pas d’accountId.
number
défaut:100
Limitez le nombre de centres d’intérêt d’annonces renvoyés.
Une réponse filtrée renvoie les catégories appliquées dans un champ specialAdCategories, afin que vous puissiez confirmer sur quoi les résultats ont été restreints. Une réponse non filtrée omet entièrement ce champ plutôt que de le renvoyer vide. Les résultats filtrés omettent aussi le champ topic sur chaque centre d’intérêt, car la recherche de Meta tenant compte de la catégorie ne le renvoie pas — lisez name à la place. Une recherche sans centre d’intérêt éligible renvoie 200 avec un tableau interests vide et count: 0, pas une erreur, et une recherche filtrée ne se rabat jamais sur des résultats non filtrés.