Skip to main content
GET
Busca intereses disponibles para la segmentación de anuncios de Facebook por palabra clave. Usa este endpoint para consultar IDs de intereses para el endpoint Impulsar publicación. Este endpoint te ayuda a descubrir opciones de segmentación basadas en intereses para tus anuncios de Facebook, junto con estimaciones del tamaño de audiencia.
  • Los IDs de intereses pueden usarse en el arreglo interests al impulsar publicaciones.
  • Los resultados se almacenan en caché durante 10 minutos.
  • Usa términos de búsqueda específicos y relevantes para obtener los mejores resultados.
  • Facebook puede devolver diferentes resultados en función del sector y la región de tu cuenta publicitaria.
  • Los campos audienceSizeLowerBound y audienceSizeUpperBound en la respuesta JSON proporcionan un rango estimado del tamaño de audiencia para el interés, y son útiles para la segmentación.
  • Usa specialAdCategories para devolver solo los intereses que Meta permite para una campaña de categoría especial de anuncios. Las solicitudes filtradas también requieren accountId.

​
Parámetros del encabezado

​
Parámetros de consulta

​
string
requerido
La consulta de búsqueda para recuperar intereses de anuncios de Facebook.No olvides escapar la consulta de búsqueda, por ejemplo Rhythm%20and%20blues%20music.
​
array
Restringe los resultados a los intereses que Meta permite segmentar a una campaña de categoría especial de anuncios. Úsalo antes de impulsar una publicación de vivienda, empleo, finanzas o política, para elegir IDs de intereses con los que el anuncio realmente será aprobado.Se admiten los siguientes valores, que coinciden con el parámetro del mismo nombre de Impulsar publicación:
  • housing
  • employment
  • financial_product_services — financial_products_services y credit se aceptan como equivalentes y se resuelven a la misma categoría
  • issues_elections_politics
  • none — se acepta por simetría con Impulsar publicación, donde significa “no está en una categoría especial de anuncios”. Se envía a Meta como regulated_categories=["NONE"]: accountId es requerido y una respuesta exitosa devuelve ["NONE"]. Esto no garantiza los mismos resultados que una búsqueda sin filtrar; un rechazo de Meta devuelve code: 368. Si quieres una búsqueda ordinaria sin filtrar, omite specialAdCategories por completo en lugar de enviar none.
Los valores no distinguen mayúsculas de minúsculas. Un valor no reconocido se rechaza con un 400 y code: 101 que enumera los valores aceptados. Ese mensaje está escrito en la forma en mayúsculas de Meta y también nombra las grafías alternativas anteriores, por lo que se lee NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT — las mismas categorías listadas aquí, no categorías adicionales. Impulsar publicación devuelve el mismo mensaje. Un valor vacío, como en ?specialAdCategories=, se rechaza de la misma manera.Pasa más de una categoría repitiendo el parámetro, por ejemplo ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. La forma con corchetes ?specialAdCategories[]=employment&specialAdCategories[]=housing también funciona. Una cadena separada por comas como ?specialAdCategories=employment,housing no se admite y se rechaza con un 400 y code: 101. Todas las categorías solicitadas se envían a Meta en una sola búsqueda. Ayrshare devuelve los resultados de Meta y no calcula ni garantiza una intersección de intereses elegibles de forma independiente. Repetir una categoría, o enviar dos grafías de la misma, se consolida en una sola categoría.Cuando proporcionas más de una categoría, el campo specialAdCategories devuelto en la respuesta se ordena alfabéticamente, en lugar de devolverse en el orden en que lo enviaste.Omite specialAdCategories por completo y el endpoint se comporta exactamente como antes: una búsqueda sin filtrar, sin necesidad de accountId y con la misma estructura de respuesta.
​
string
Requerido cuando se proporciona specialAdCategories, e ignorado en caso contrario. El ID de la cuenta publicitaria de Facebook en la que se buscan los intereses, sin el prefijo act_ — el mismo valor que acepta Impulsar publicación. Recupéralo desde el endpoint de cuentas publicitarias. Debe ser numérico; un act_ inicial se acepta y se elimina, y cualquier otra cosa se rechaza con un 400 y code: 101.
Meta solo ofrece la búsqueda de intereses por categoría en una cuenta publicitaria, por lo que una solicitud que proporcione specialAdCategories sin accountId se rechaza con un 400 y code: 101 antes de que se ejecute ninguna búsqueda. Una solicitud sin specialAdCategories no cambia y sigue sin necesitar accountId.
​
number
predeterminado:100
Limita el número de intereses de anuncios devueltos.
Una respuesta filtrada devuelve las categorías aplicadas en un campo specialAdCategories, para que puedas confirmar con qué se acotaron los resultados. Una respuesta sin filtrar omite ese campo por completo en lugar de devolverlo vacío. Los resultados filtrados también omiten el campo topic en cada interés, porque la búsqueda por categoría de Meta no lo devuelve — lee name en su lugar. Una búsqueda sin intereses elegibles devuelve 200 con un arreglo interests vacío y count: 0, no un error, y una búsqueda filtrada nunca recurre a resultados sin filtrar.