Analíticas de una publicación por ID social

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "facebook"
    ],
    "searchPlatformId": true // Required
}

{
    // Array of Social Post IDs (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "twitter"
    ],
    "searchPlatformId": true // Required
}

{
  /**
    The response is the same as Analytics on a Post.
    Please see that endpoint for details.

    Note: Some metrics are not available for posts not owned by the authorized account.
    For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
  */
}

{
    "twitter": [
        {
            "id": "1313589441919827982",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "entities": {
                    "urls": [
                        {
                            "start": 77,
                            "end": 96,
                            "url": "https://t.co/abc123",
                            "expandedUrl": "https://www.ayrshare.com/docs",
                            "displayUrl": "ayrshare.com/docs",
                            "unwoundUrl": "https://www.ayrshare.com/docs"
                        }
                    ],
                    "hashtags": [
                        {
                            "start": 97,
                            "end": 112,
                            "tag": "SocialMediaAPI"
                        }
                    ],
                    "mentions": [
                        {
                            "start": 113,
                            "end": 122,
                            "username": "ayrshare"
                        }
                    ]
                },
                "name": "Wonder World",
                "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                "publicMetrics": {
                    "retweetCount": 0,
                    "quoteCount": 0,
                    "likeCount": 0,
                    "replyCount": 0,
                    "bookmarkCount": 0,
                    "impressionCount": 23
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 1,
                    "engagements": 1,
                    "impressionCount": 5
                },
                "organicMetrics": {
                    "likeCount": 0,
                    "impressionCount": 5,
                    "replyCount": 0,
                    "retweetCount": 0,
                    "userProfileClicks": 1
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        },
        {
            "id": "1313589441919827999",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
            "analytics": {
                "created": "2022-09-08T14:30:00.000Z",
                "name": "Wonder World",
                "post": "Another great day for social media automation!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 8,
                    "engagements": 12,
                    "impressionCount": 145
                },
                "organicMetrics": {
                    "likeCount": 15,
                    "impressionCount": 145,
                    "replyCount": 3,
                    "retweetCount": 5,
                    "userProfileClicks": 8
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "backfilledFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "recoveredFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "lastUpdated": "2023-12-08T03:40:31.185Z",
    "nextUpdate": "2023-12-08T03:51:31.185Z",
    "youtube": {
        "action": "post",
        "status": "error",
        "code": 186,
        "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
        "id": "dtuu-jDp4381"
    }
}

POST

analytics

post

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "facebook"
    ],
    "searchPlatformId": true // Required
}

{
    // Array of Social Post IDs (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "twitter"
    ],
    "searchPlatformId": true // Required
}

{
  /**
    The response is the same as Analytics on a Post.
    Please see that endpoint for details.

    Note: Some metrics are not available for posts not owned by the authorized account.
    For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
  */
}

{
    "twitter": [
        {
            "id": "1313589441919827982",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "entities": {
                    "urls": [
                        {
                            "start": 77,
                            "end": 96,
                            "url": "https://t.co/abc123",
                            "expandedUrl": "https://www.ayrshare.com/docs",
                            "displayUrl": "ayrshare.com/docs",
                            "unwoundUrl": "https://www.ayrshare.com/docs"
                        }
                    ],
                    "hashtags": [
                        {
                            "start": 97,
                            "end": 112,
                            "tag": "SocialMediaAPI"
                        }
                    ],
                    "mentions": [
                        {
                            "start": 113,
                            "end": 122,
                            "username": "ayrshare"
                        }
                    ]
                },
                "name": "Wonder World",
                "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                "publicMetrics": {
                    "retweetCount": 0,
                    "quoteCount": 0,
                    "likeCount": 0,
                    "replyCount": 0,
                    "bookmarkCount": 0,
                    "impressionCount": 23
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 1,
                    "engagements": 1,
                    "impressionCount": 5
                },
                "organicMetrics": {
                    "likeCount": 0,
                    "impressionCount": 5,
                    "replyCount": 0,
                    "retweetCount": 0,
                    "userProfileClicks": 1
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        },
        {
            "id": "1313589441919827999",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
            "analytics": {
                "created": "2022-09-08T14:30:00.000Z",
                "name": "Wonder World",
                "post": "Another great day for social media automation!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 8,
                    "engagements": 12,
                    "impressionCount": 145
                },
                "organicMetrics": {
                    "likeCount": 15,
                    "impressionCount": 145,
                    "replyCount": 3,
                    "retweetCount": 5,
                    "userProfileClicks": 8
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "backfilledFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "recoveredFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "lastUpdated": "2023-12-08T03:40:31.185Z",
    "nextUpdate": "2023-12-08T03:51:31.185Z",
    "youtube": {
        "action": "post",
        "status": "error",
        "code": 186,
        "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
        "id": "dtuu-jDp4381"
    }
}

Obtén analíticas de publicaciones que no se originaron mediante Ayrshare proporcionando el ID de publicación social de bajo nivel. Este ID se devuelve en el campo postIds del endpoint /post. La cuenta vinculada debe ser el propietario de la publicación para obtener las analíticas (excepción: YouTube; ver a continuación). Plataformas admitidas: Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter y YouTube.

La llamada es la misma que la del endpoint Analíticas de una publicación. La diferencia clave es que se usa el ID de publicación devuelto por la red social en lugar del ID de Ayrshare. Además, incluye el parámetro searchPlatformId: true para notificar al endpoint que estás buscando por el ID de publicación social.
Usa el endpoint Obtener todo el historial de publicaciones para recuperar publicaciones e IDs originadas fuera de Ayrshare que se encuentran en el campo id.
Se recomienda usar solo para publicaciones no enviadas mediante Ayrshare. Para publicaciones enviadas mediante Ayrshare, usa el endpoint de analíticas.
Las analíticas de publicaciones de Instagram publicadas antes de que la cuenta del usuario se convirtiera de personal a comercial tienen analíticas limitadas.
Si obtienes analíticas de YouTube para una publicación que no pertenece a tu canal usando el método de ID social, la API devolverá metadatos descriptivos sobre el contenido pero mostrando ceros para todas las métricas numéricas. La información descriptiva, como título, descripción, etiquetas, título del canal, estado de privacidad y URLs de miniaturas, se completará correctamente, brindando contexto sobre el contenido del video. Sin embargo, todas las métricas numéricas de rendimiento, incluyendo visualizaciones, me gusta, comentarios, compartidos, cambios de suscriptores, tiempo de visualización y adiciones a listas de reproducción, se devolverán como cero.
Al usar postIds para hilos de X/Twitter, el ID de publicación social de cada tuit debe proporcionarse individualmente; los tuits del hilo no se incluyen automáticamente al consultar la publicación principal.

Parámetros de encabezado

Parámetros del cuerpo

Se debe proporcionar id o postIds. Usa id para una sola publicación o postIds para obtener analíticas de varias publicaciones en una sola solicitud.

string

ID de publicación social devuelto por el endpoint /post. Este es el campo id de una red social individual que se encuentra en el arreglo postIds. Se requiere id o postIds.

postIds

array

Arreglo de IDs de publicación social para obtener analíticas de varias publicaciones en una sola solicitud. Se permiten máximo 100 IDs. Se requiere id o postIds.

{
  "postIds": ["1979851549871354062", "2011793803951137234"]
}

platforms

array

requerido

Arreglo de cadenas con las plataformas de las que se quieren obtener analíticas. Solo se permite un valor.Valores disponibles:

{
  "platforms": ["facebook", "instagram", "linkedin", "threads",
                "tiktok", "twitter", "youtube"]
}

searchPlatformId

boolean

predeterminado:false

requerido

Establece en true para buscar por el ID de publicación social.

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "facebook"
    ],
    "searchPlatformId": true // Required
}

{
    // Array of Social Post IDs (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "twitter"
    ],
    "searchPlatformId": true // Required
}

Cuando las métricas acumulativas (por ejemplo, me gusta, comentarios, visualizaciones) no están disponibles temporalmente en la red social, la API las completa automáticamente a partir de datos almacenados. Pueden aparecer dos campos opcionales en el objeto analytics por plataforma:

backfilledFrom (cadena, ISO 8601) — Presente cuando una o más métricas acumulativas fueron sustituidas por datos almacenados. La marca de tiempo indica cuándo se actualizaron por última vez los datos almacenados.
recoveredFrom (cadena, ISO 8601) — Presente cuando toda la respuesta de analíticas se recuperó de datos almacenados debido a una falla completa de la API. La marca de tiempo indica cuándo se actualizaron por última vez los datos almacenados.

Los datos almacenados con más de 4 días de antigüedad se consideran obsoletos y no se usarán para relleno ni recuperación.

{
  /**
    The response is the same as Analytics on a Post.
    Please see that endpoint for details.

    Note: Some metrics are not available for posts not owned by the authorized account.
    For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
  */
}

{
    "twitter": [
        {
            "id": "1313589441919827982",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "entities": {
                    "urls": [
                        {
                            "start": 77,
                            "end": 96,
                            "url": "https://t.co/abc123",
                            "expandedUrl": "https://www.ayrshare.com/docs",
                            "displayUrl": "ayrshare.com/docs",
                            "unwoundUrl": "https://www.ayrshare.com/docs"
                        }
                    ],
                    "hashtags": [
                        {
                            "start": 97,
                            "end": 112,
                            "tag": "SocialMediaAPI"
                        }
                    ],
                    "mentions": [
                        {
                            "start": 113,
                            "end": 122,
                            "username": "ayrshare"
                        }
                    ]
                },
                "name": "Wonder World",
                "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                "publicMetrics": {
                    "retweetCount": 0,
                    "quoteCount": 0,
                    "likeCount": 0,
                    "replyCount": 0,
                    "bookmarkCount": 0,
                    "impressionCount": 23
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 1,
                    "engagements": 1,
                    "impressionCount": 5
                },
                "organicMetrics": {
                    "likeCount": 0,
                    "impressionCount": 5,
                    "replyCount": 0,
                    "retweetCount": 0,
                    "userProfileClicks": 1
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        },
        {
            "id": "1313589441919827999",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
            "analytics": {
                "created": "2022-09-08T14:30:00.000Z",
                "name": "Wonder World",
                "post": "Another great day for social media automation!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 8,
                    "engagements": 12,
                    "impressionCount": 145
                },
                "organicMetrics": {
                    "likeCount": 15,
                    "impressionCount": 145,
                    "replyCount": 3,
                    "retweetCount": 5,
                    "userProfileClicks": 8
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "backfilledFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "recoveredFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "lastUpdated": "2023-12-08T03:40:31.185Z",
    "nextUpdate": "2023-12-08T03:51:31.185Z",
    "youtube": {
        "action": "post",
        "status": "error",
        "code": 186,
        "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
        "id": "dtuu-jDp4381"
    }
}

Analíticas de una publicación Analíticas de una red social

⌘I

​Parámetros de encabezado

​Parámetros del cuerpo

Parámetros de encabezado

Parámetros del cuerpo