Skip to main content
GET
Recupera los anuncios que se han impulsado para una publicación específica de Instagram. Este endpoint de anuncios impulsados proporciona información detallada sobre los anuncios impulsados, incluyendo estado, gasto actual, métricas de rendimiento (analíticas) y enlaces de vista previa.
  • Las métricas son totales en tiempo real de los anuncios. Si necesitas datos históricos, usa el endpoint de historial de anuncios.
  • La URL previewLink te permite compartir la vista previa del anuncio con tus colegas, para que puedan ver el anuncio durante 24 horas en los distintos formatos de Instagram. Las visualizaciones del anuncio por parte de tus colegas no se contabilizarán en tu gasto publicitario.

Parámetros del encabezado

Parámetros de consulta

string
requerido
Recupera todos los anuncios bajo el ID de cuenta.El ID de la cuenta publicitaria, con o sin el prefijo act_ (1234567890 o act_1234567890).Requerido si adId, socialPostId o postId no están establecidos.
string
requerido
Recupera un anuncio con el ID de anuncio.Requerido si accountId, socialPostId o postId no están establecidos.
string
requerido
Recupera anuncios con el ID de publicación social de Instagram.Requerido si accountId, adId o postId no están establecidos.
number
predeterminado:25
Recupera un máximo de limit anuncios. El máximo es 300; los valores superiores se limitan a 300.
string
requerido
Recupera anuncios con el ID de publicación de Ayrshare.Requerido si accountId, adId o socialPostId no están establecidos.
string
predeterminado:"all"
Filtra los anuncios por estado. Omite este parámetro para devolver anuncios de cualquier estado. Los valores válidos son:
  • active
  • paused
  • deleted
  • archived