Asters API
Go to Asters
  • 👋API Documentation
  • Overview
    • Getting started
    • Authentication
  • Endpoints
    • Workspaces
    • Social accounts
    • Labels
    • Posts
    • Analytics
  • Extra
    • Limitations
    • HTTP responses
    • Language codes
Powered by GitBook
On this page

Was this helpful?

  1. Endpoints

Analytics

This endpoint is used to obtain the list of posts' analytics of a social account.

List of posts' analytics of a social account

POST https://api.asters.ai/api/external/v1.0/analytics/posts

All Asters links are hosted on AWS S3 bucket in Frankfurt

Headers

Key
Value

x-api-key*

API Key generated in Asters for user authentication

Example Body

{
    "socialAccountId":"17841435234252299",
    "page": 1,
    "filters": {
        "date": {
              "from": "04-01-2025",
              "to": "04-30-2025"
        }
    }
}
{
    "data": [
        {
            "_id": "6811fe5563b783ce13f35098",
            "postId": "18020843483697397",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 4,
            "content_type": "reels",
            "createdAt": "2025-04-22T13:15:38.000Z",
            "fanbase_at_pubblication_time": 37745,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQNQPADofF3FddFHEbe9YQRzCYRvLmwTGjt3iAREShMTttkDc75AqoYlllrVvSV0njzgAhh5x5Sf9eiYzGNzM4oMPOKi-uGFub_M0JU.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=105&_nc_oc=AdnutZSPeiYC0jJoKdDYGEsG0arjLKYO1-BFzgJduGPsFGlxKCE2fi0vGT2lIiNyKOo&vs=9548691608581009_1257036197&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC84QTQ1RjQ3NUI4MTI5RTk3QzFCOEREMDE4MzlCMTZCOV92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dFVW1TUjFlemctOWdNQUVBTTFDSzVkVVVEOTFia1lMQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJsTtjuyf894%2FFQIoAkMzLBdAHqLQ5WBBiRgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfFHBiCRBh-WN4mFJoGGCq9eUeapNnlK8vH5sGsf_WLj8A&oe=6813F417&_nc_sid=1d576d",
            "interactions_rate": 5,
            "labels": [],
            "likes": 222,
            "media_type": "video",
            "message": "What’s the weirdest thing your pup has ever eaten? 🤨🐾\nThis puppy just discovered dragon fruit… and the couch.",
            "permalinkUrl": "https://www.instagram.com/reel/DIwAqahJ4_Q/",
            "plays": -1,
            "provider": "instagram",
            "reach": 4514,
            "saved": 12,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f35099",
            "postId": "18269311507279401",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 4,
            "content_type": "reels",
            "createdAt": "2025-04-20T13:10:38.000Z",
            "fanbase_at_pubblication_time": 37763,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQOqskAJp2xYN6j24LeO2n97zvRckXxOvH1VPrLj5pLEhiHpsMUCjM-j-uiad4w5OjJ5r_68vzIU_N5JYMkAGEgPR-PAI1m8XqeqUhc.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=107&_nc_oc=AdmrS9ZFAnmn21sAcj-qjPI6DZxZJbEr1AZMLT-OCHr5af5vTEAEJSmXs5p3HGz_JF4&vs=1357568348621460_1155238052&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85MzQzRjk4REE4Q0NBMUEzQkNFNjZFNzI5M0M0RkQ4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dKY1FTUjBzRFRuQUFiTURBSEl4R0VYVWF2NWJicV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJtT3hI763dlBFQIoAkMzLBdAJjztkWhysBgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfEPaFZRYgLw1BGVHWmBNR_blBWRvvjUHGpggK00hMOhkw&oe=6813D72D&_nc_sid=1d576d",
            "interactions_rate": 5,
            "labels": [],
            "likes": 244,
            "media_type": "video",
            "message": "Golden-approved spa day: 10/10, pure bliss 🐶💦✨",
            "permalinkUrl": "https://www.instagram.com/reel/DIq2hO-S1eR/",
            "plays": -1,
            "provider": "instagram",
            "reach": 4869,
            "saved": 10,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f3509a",
            "postId": "18063415265056230",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 8,
            "content_type": "reels",
            "createdAt": "2025-04-16T13:01:36.000Z",
            "fanbase_at_pubblication_time": 37746,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQMZBoAm6-VSqvSOZVppEnwEtBmlVOvv54gpHj2RcY4y6xHGliWQmMsQpIWDBlRlMQy40w3-UcXtPYIICLwRdvs7BMjyEdhqvyHAgaQ.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=107&_nc_oc=Adm4-jBrmEDRgzg4zgAKeBFE-Sy0VPjd02yXBM8eRvCe8MPC8s7Uartjl3CQWogswLQ&vs=1384590839523045_4004826436&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC84QTREQUQyOUMwNTg4RTlFMDUzMzEyQjNBRTY1RTNCRF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dNanVTQjJYazI1SnUwMEdBTjFJeGt0b3JNWVNicV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJp6CvsXiu61AFQIoAkMzLBdAMtP3ztkWhxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfHitsJcVnk7q7rmGgfw8lhcZ3aEMwQmZ4PylxNLEEsizw&oe=6813F6B1&_nc_sid=1d576d",
            "interactions_rate": 12,
            "labels": [],
            "likes": 457,
            "media_type": "video",
            "message": "Nobody told me golden retrievers come with 5 personalities and zero warning signs 😅🐾\nWhich one does your dog unlock first thing in the morning? 👀☕️\nComment below!",
            "permalinkUrl": "https://www.instagram.com/reel/DIgiR74o-q-/",
            "plays": -1,
            "provider": "instagram",
            "reach": 3907,
            "saved": 16,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f3509b",
            "postId": "18042578456617222",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 20,
            "content_type": "reels",
            "createdAt": "2025-04-15T13:01:06.000Z",
            "fanbase_at_pubblication_time": 37737,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQMq_5uegzSTWGSQM0gD143kbjN5GN-LWPXrO_Nj-rRwlxrNZMIgHMIlyU64XkDjIKAB7udPkJuRU2oRRrJlXultPzkNYR8d6YK1XaA.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNTc2LmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=106&_nc_oc=AdmSNFUphEyPDQHbwtFVf33a9KtshbaMDQ1l2QSjHeiAzar0LQa2h5e8sWO6L6x1Ej8&vs=1299320367833596_2312219236&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC84NTRGMjkwRkY0REE3OTU0NjI4MkE4RDMxQkJDNkU5MF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dMbzZTQjEyUmJxQXgzVUdBQUxRU1l4d0pSVmxia1lMQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJoSy9ert2d4%2FFQIoAkMzLBdANKOVgQYk3RgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfFw0221b82oEX74LkDGvuGEsRjXjRuvWG2P_5ziVRq37w&oe=6813F7C6&_nc_sid=1d576d",
            "interactions_rate": 15,
            "labels": [],
            "likes": 992,
            "media_type": "video",
            "message": "If I fits, I sits. Even if I absolutely do NOT fits. 🐶🪺😂",
            "permalinkUrl": "https://www.instagram.com/reel/DId9bbui82f/",
            "plays": -1,
            "provider": "instagram",
            "reach": 6982,
            "saved": 59,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f3509c",
            "postId": "18081317227725961",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 5,
            "content_type": "reels",
            "createdAt": "2025-04-11T16:18:36.000Z",
            "fanbase_at_pubblication_time": 37744,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQPrVNPL33QAlhTur8m7VdemQVv3t3EMaT4ApQcpEzks_YtprUOiCMo0eXUWCPMDMuUYVahQ0suTGWd4ZPQemv4eqZHEw8BEyeDqV-0.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=109&_nc_oc=AdlfxW4jYccvF1Q081HLp-VbnB9SAc8RVd-q4HWY6c_wF1q4vFJcqxw9mf6KWG2e4_Y&vs=1876227623195661_3827984238&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9DNjRDNjYzOTNCMTk4MTUyRjEwNkRENjFCNDYxRjU4OV92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dFUnJHaDE3UnVvWWdKd0dBQVZIemx1VUprTk9icV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJtq0gbvV0PFAFQIoAkMzLBdALdqfvnbItBgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfE6YC4CAgNfqFQpYwl1mMlqYBOX6Q-JU_HIMIYb8tMXsQ&oe=6813D6AF&_nc_sid=1d576d",
            "interactions_rate": 9,
            "labels": [],
            "likes": 484,
            "media_type": "video",
            "message": "They don’t just live with us… they love with their whole heart. 🥹🐾",
            "permalinkUrl": "https://www.instagram.com/reel/DIUA2_QRsz8/",
            "plays": -1,
            "provider": "instagram",
            "reach": 5151,
            "saved": 24,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f3509d",
            "postId": "17966590763746813",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 5,
            "content_type": "reels",
            "createdAt": "2025-04-08T18:12:05.000Z",
            "fanbase_at_pubblication_time": 37699,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQNk8JSnvPzQM6ntZhQr4FIgJ8mYFG89lMwTt6iIifnaFCePAAOL4cNZIixHbxeMSQgVfExVmgp8yzPlqqeXkriuo67nxJeSfgOEhf0.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=110&_nc_oc=Adl40EXmkUw0DlQII_wv6rrfCtDTFNXKGGoi-vrcTd_IEOgr-B0tKkZd5njzD67rYZc&vs=539988972107559_553929554&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC84MjRDRUVENEUxNjk5QUYyRThEMzNFREU5NTYzNDFBRF92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dMYmtNUjFYaUpYeWNlNEVBQ09Bd2hTU2RJODNicV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJorQzYLPgvJAFQIoAkMzLBdAQSKwIMSbphgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfH2r6yksAnR-WZx5eQy1xmPy8Y0FcaxWTVLpVYqsfSqrg&oe=6813C2F6&_nc_sid=1d576d",
            "interactions_rate": 14,
            "labels": [],
            "likes": 633,
            "media_type": "video",
            "message": "Be honest… did your second dog completely level up your life too? 🐶❤️🐶",
            "permalinkUrl": "https://www.instagram.com/reel/DIMfeXBBfXo/",
            "plays": -1,
            "provider": "instagram",
            "reach": 4569,
            "saved": 38,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f3509e",
            "postId": "18061783478475767",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 7,
            "content_type": "reels",
            "createdAt": "2025-04-07T17:04:06.000Z",
            "fanbase_at_pubblication_time": 37698,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQOtwBgw8aV9HFRoZFmGbkofKpeEOHxmSwqazsVNk7CtTFj-VfON35RWoeQp67hWPvhHgwJGsSTNT9yaeVQWCOJD-5jC3jZs_hbefhw.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=107&_nc_oc=Adlen6IRlOZ9__ZpqXdeebpSLhIP4YifgkUDg2V3OqrbGJWUkYB_eZBuE8BEMZ6oFnA&vs=659340703460199_510862753&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9FOTRBOEFEQjVCMzA1QUU4NjFDNkZGNjNDMzMxNUJBMl92aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dBNFJJQjNsZzFyaFYtNEJBRlpjWF9JT0hHWmJicV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJsS9gaf9uo5AFQIoAkMzLBdALwQYk3S8ahgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfH-7dBsegCVlUndK_V856RWHCxMfPjTvggNf1FPLyswKQ&oe=6813C81D&_nc_sid=1d576d",
            "interactions_rate": 9,
            "labels": [],
            "likes": 373,
            "media_type": "video",
            "message": "Me trying to reach my goals without leaving my comfort zone 😅🎯 …but then I nail it 💪🐾",
            "permalinkUrl": "https://www.instagram.com/reel/DIJy5P_sC-_/",
            "plays": -1,
            "provider": "instagram",
            "reach": 4196,
            "saved": 27,
            "isValid": true
        },
        {
            "_id": "6811fe5563b783ce13f3509f",
            "postId": "18032713838636836",
            "__v": 0,
            "accountName": "Smily Golden Retriever",
            "account_id": "17841435234252299",
            "astersCreatedAt": "2025-04-30T03:25:08.865Z",
            "astersUpdateAt": "2025-04-30T10:41:25.797Z",
            "comments": 6,
            "content_type": "reels",
            "createdAt": "2025-04-05T14:48:05.000Z",
            "fanbase_at_pubblication_time": 37696,
            "imageUrl": "https://scontent-lhr6-1.cdninstagram.com/o1/v/t16/f2/m86/AQN4IPm7o9_qDCdqhVQfF9Sf5_RuEkji1EQxNnhpqIIEpkT2Uydlqi1v0ofCVClZdWfaqzh1JR3Ai6wrYf7Em1izgeqAGVXIWEw9VNQ.mp4?efg=eyJ2ZW5jb2RlX3RhZyI6InZ0c192b2RfdXJsZ2VuLmNsaXBzLnVua25vd24tQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSJ9&_nc_ht=scontent-lhr6-1.cdninstagram.com&edm=AM6HXa8EAAAA&_nc_gid=KG51x-yHi5ZzImRWTZ6rvg&_nc_cat=102&_nc_oc=AdlFzuuA7ArEh_KnM18u5mazAS9qevdv1UCtNP38lUUAojok9ATdVSa3m6Cx19NCaew&vs=676384958272836_3733203678&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC81MDQ0MkNBNUU4QzdCOTI3QjE3RUY0RTU1ODhFQjI5N192aWRlb19kYXNoaW5pdC5tcDQVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dQd29IaDB1bENLaG9URUVBTTVjWE9Rb3lxZ0xicV9FQUFBRhUCAsgBACgAGAAbAYgHdXNlX29pbAExFQAAJpq4j7SvuOg%2FFQIoAkMzLBdALUAAAAAAABgSZGFzaF9iYXNlbGluZV8xX3YxEQB1AGXmnQEA&ccb=9-4&oh=00_AfF4inVaqkv1gz1DQA2C3zHzTQePr5Cx1UMcN9oUgI6BlQ&oe=6813EBFE&_nc_sid=1d576d",
            "interactions_rate": 11,
            "labels": [],
            "likes": 364,
            "media_type": "video",
            "message": "Not just a dog — a heartbeat at our feet, a soul at peace 🐶✨",
            "permalinkUrl": "https://www.instagram.com/reel/DIEZuNpi46I/",
            "plays": -1,
            "provider": "instagram",
            "reach": 3279,
            "saved": 13,
            "isValid": true
        }
    ],
    "totalItems": 8,
    "totalPages": 1,
    "page": 1
}

{
    // Response
}

PreviousPostsNextLimitations

Last updated 8 days ago

Was this helpful?