Skip to main content
GET
Recupere anúncios que foram impulsionados para uma publicação específica do Instagram. Este endpoint de anúncios impulsionados fornece informações detalhadas sobre os anúncios impulsionados, incluindo status, gasto atual, métricas de desempenho (analytics) e links de visualização.
  • As métricas são totais em tempo real dos anúncios. Se precisar de dados históricos, use o endpoint de histórico de anúncios.
  • A URL previewLink permite compartilhar o anúncio de visualização com seus colegas, para que possam ver o anúncio por 24 horas nos vários formatos do Instagram. As visualizações do anúncio pelos seus colegas não serão contabilizadas no gasto do seu anúncio.

Parâmetros de cabeçalho

Parâmetros de consulta

number
obrigatório
Recupera todos os anúncios sob o ID da conta.Obrigatório se adId, socialPostId ou postId não estiverem definidos.
string
obrigatório
Recupera um anúncio pelo ID do anúncio.Obrigatório se accountId, socialPostId ou postId não estiverem definidos.
string
obrigatório
Recupera anúncios pelo ID da publicação social do Instagram.Obrigatório se accountId, adId ou postId não estiverem definidos.
number
padrão:25
Recupera no máximo limit anúncios. O máximo é 300; valores maiores são limitados a 300.
string
obrigatório
Recupera anúncios pelo ID da publicação da Ayrshare.Obrigatório se accountId, adId ou socialPostId não estiverem definidos.
string
padrão:"all"
Filtra anúncios por status do anúncio. Omita este parâmetro para retornar anúncios de todos os status. Valores válidos são:
  • active
  • paused
  • deleted
  • archived