Skip to main content
GET
Pesquise por interesses disponíveis para segmentação de anúncios no Facebook por palavra-chave. Use este endpoint para buscar IDs de interesses para o endpoint Boost Post. Este endpoint ajuda você a descobrir opções de segmentação baseadas em interesses para seus anúncios do Facebook, além de estimativas de tamanho de audiência.
  • IDs de interesses podem ser usados no array interests ao impulsionar publicações.
  • Os resultados são armazenados em cache por 10 minutos.
  • Use termos de pesquisa específicos e relevantes para obter melhores resultados.
  • O Facebook pode retornar resultados diferentes com base no setor e na região da sua conta de anúncios.
  • Os campos audienceSizeLowerBound e audienceSizeUpperBound na resposta JSON fornecem uma faixa estimada do tamanho da audiência para o interesse e é útil para segmentação.
  • Use specialAdCategories para retornar apenas os interesses que a Meta permite para uma campanha de categoria especial de anúncios. Requisições filtradas também exigem accountId.

​
Parâmetros de cabeçalho

​
Parâmetros de consulta

​
string
obrigatório
A consulta de pesquisa para recuperar interesses de anúncios do Facebook.Não se esqueça de fazer o escape da consulta de pesquisa, por exemplo Rhythm%20and%20blues%20music.
​
array
Restringe os resultados aos interesses que a Meta permite que uma campanha de categoria especial de anúncios segmente. Use isto antes de impulsionar uma publicação de moradia, emprego, financeira ou política, para escolher IDs de interesses para os quais o anúncio será de fato aprovado.Os seguintes valores são suportados, correspondendo ao parâmetro de mesmo nome do Boost Post:
  • housing
  • employment
  • financial_product_services — financial_products_services e credit são aceitos como equivalentes e resolvem para a mesma categoria
  • issues_elections_politics
  • none — aceito por simetria com o Boost Post, onde significa “não está em uma categoria especial de anúncios”. Ele é enviado à Meta como regulated_categories=["NONE"]: accountId é obrigatório e uma resposta bem-sucedida ecoa ["NONE"]. Isso não garante os mesmos resultados de uma pesquisa sem filtro; uma rejeição da Meta retorna code: 368. Omita specialAdCategories por completo em vez de enviar none se você quiser uma pesquisa comum sem filtro.
Os valores não diferenciam maiúsculas de minúsculas. Um valor não reconhecido é rejeitado com um 400 e code: 101 listando os valores aceitos. Essa mensagem é escrita na forma em maiúsculas da Meta e também menciona as grafias alternativas acima, então ela aparece como NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT — as mesmas categorias listadas aqui, não categorias extras. O Boost Post retorna a mesma mensagem. Um valor vazio, como em ?specialAdCategories=, é rejeitado da mesma forma.Passe mais de uma categoria repetindo o parâmetro, por exemplo ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. A forma com colchetes ?specialAdCategories[]=employment&specialAdCategories[]=housing também funciona. Uma string separada por vírgulas, como ?specialAdCategories=employment,housing, não é suportada e é rejeitada com um 400 e code: 101. Todas as categorias solicitadas são enviadas à Meta em uma única pesquisa. A Ayrshare retorna os resultados da Meta e não calcula nem garante uma interseção de interesses elegíveis de forma independente. Repetir uma categoria, ou enviar duas grafias da mesma categoria, é reduzido a uma única categoria.Quando você fornece mais de uma categoria, o campo specialAdCategories ecoado de volta na resposta é ordenado alfabeticamente, em vez de retornado na ordem em que você o enviou.Omita specialAdCategories por completo e o endpoint se comporta exatamente como antes: uma pesquisa sem filtro, sem necessidade de accountId e com o mesmo formato de resposta.
​
string
Obrigatório quando specialAdCategories é fornecido, e ignorado caso contrário. O ID da conta de anúncios do Facebook na qual os interesses estão sendo pesquisados, sem o prefixo act_ — o mesmo valor que o Boost Post recebe. Obtenha-o no endpoint de contas de anúncios. Ele deve ser numérico; um act_ inicial é aceito e removido, e qualquer outra coisa é rejeitada com um 400 e code: 101.
A Meta só oferece pesquisa de interesses com reconhecimento de categoria em uma conta de anúncios, então uma requisição que fornece specialAdCategories sem accountId é rejeitada com um 400 e code: 101 antes de qualquer pesquisa ser executada. Uma requisição sem specialAdCategories permanece inalterada e continua não precisando de accountId.
​
number
padrão:100
Limita o número de interesses de anúncios retornados.
Uma resposta filtrada ecoa as categorias aplicadas de volta em um campo specialAdCategories, para que você possa confirmar com base em que os resultados foram restringidos. Uma resposta sem filtro omite esse campo por completo, em vez de retorná-lo vazio. Resultados filtrados também omitem o campo topic em cada interesse, porque a pesquisa com reconhecimento de categoria da Meta não o retorna — leia name em vez disso. Uma pesquisa sem interesses elegíveis retorna 200 com um array interests vazio e count: 0, não um erro, e uma pesquisa filtrada nunca recorre a resultados sem filtro.