API Documentation

Instagram Reels API

Page through public Instagram Reels with returned cursors and available engagement data.

Test API

Page through public Instagram Reels with returned cursors and available engagement data.

Open product page and API Tester

Endpoint and authentication

POST https://api.goanyapi.com/api/v1/instagram/user/reels

Results return synchronously, without tasks or polling. Authenticate using Authorization: Bearer YOUR_API_KEY and send a JSON request body. There are no Path or Query parameters.

Input parameters

Page size is fixed at 12; actual results may be fewer. Do not send first, count or page_size. Omit cursor initially and use data.result.next_cursor for the next page.

ParameterLocationTypeRequiredDefaultConstraints and meaning
AuthorizationHeaderstringYes—Bearer YOUR_API_KEY
Content-TypeHeaderstringYesapplication/jsonapplication/json
usernameJSON bodystringYes—Username, @username or full Instagram profile URL, optionally ending in /reels/ or /tagged/. URL parsing is local and adds no separate charge. Short links and other resource types are unsupported. maxLength=2048
cursorJSON bodystringNo—Omit on the first request. Reuse data.result.next_cursor only when returned; never invent an offset. Page size is fixed at 12; do not send first, count or page_size. maxLength=8192

Use the same resource parameter for a raw identifier or supported full resource URL; no prerequisite ID lookup is needed. URL parsing adds no request or separate charge. Short links and other resource types are unsupported.

Username, @username or full Instagram profile URL, optionally ending in /reels/ or /tagged/. URL parsing is local and adds no separate charge. Short links and other resource types are unsupported.

Request example

POST /api/v1/instagram/user/reels
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "username": "https://www.instagram.com/peggyzou89/reels/"
}

Output fields

Success returns HTTP 200. Business results are in data.result. Null, empty strings, empty arrays and missing business fields are preserved; zero is a valid statistic. Empty display fields do not invalidate an otherwise successful request.

FieldTypeMeaning
codestringok on success; error code otherwise
messagestringStatus message
data.resultobject / nullBusiness data; null is preserved
data.creditsUsedintegerCredits charged using current configuration
data.remainingCreditsnumberBalance after settlement
data.result.usernamestringPublic business field; may be null, empty or absent
data.result.user_idstringPublic business field; may be null, empty or absent
data.result.countintegerCount returned in this response, not a platform-wide total
data.result.postsarrayRecords in this response
data.result.posts[].codestringPublic business field; may be null, empty or absent
data.result.posts[].pkstringPublic business field; may be null, empty or absent
data.result.posts[].urlstringPublic business field; may be null, empty or absent
data.result.posts[].taken_atnull (observed)Public business field; may be null, empty or absent
data.result.posts[].userobjectPublic business field; may be null, empty or absent
data.result.posts[].user.pkstringPublic business field; may be null, empty or absent
data.result.posts[].user.idstringPublic business field; may be null, empty or absent
data.result.posts[].like_countintegerPublic business field; may be null, empty or absent
data.result.posts[].comment_countintegerPublic business field; may be null, empty or absent
data.result.posts[].play_countintegerPublic business field; may be null, empty or absent
data.result.posts[].captionnull (observed)Public business field; may be null, empty or absent
data.result.posts[].has_audionull (observed)Public business field; may be null, empty or absent
data.result.posts[].sizearrayPublic business field; may be null, empty or absent
data.result.posts[].video_urlsarrayPublic business field; may be null, empty or absent
data.result.posts[].coverstringPublic business field; may be null, empty or absent
data.result.next_cursorstringNext-page cursor for cursor; never infer an offset when empty
data.result.has_morebooleanReports more results; also requires a valid different next cursor

Omit cursor on the first request. Keep other filters unchanged and use only the returned next-page cursor. Each page is a separate billed request. Stop when data.result.has_more is false or the cursor is empty or unchanged. Returned count can differ from requested size; do not infer a total.

Real response example

Saved from a real successful response with public business fields. The example omits live data.creditsUsed and data.remainingCredits, which use current configuration and account balance. No list records are omitted. Media URLs may expire. Displaying the example sends no request or charge.

{
  "code": "ok",
  "message": "ok",
  "data": {
    "result": {
      "username": "peggyzou89",
      "user_id": "17841445318616624",
      "count": 12,
      "posts": [
        {
          "code": "DcuF5s7BIUh",
          "pk": "3976141476492248353",
          "url": "https://www.instagram.com/reel/DcuF5s7BIUh/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 19495,
          "comment_count": 112,
          "play_count": 1174904,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/786213235_28582403764699464_7324963403489356884_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jg_qTtomW0MQ7kNvwHhqneV&_nc_oc=AdprUvjo07vlRlOx2ip-KvWLFwqf2NOotTh6HUu2tf4AVPxshlgrNOIXFP3WTQZ_QOQ&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQcZ2-IXCqD9bro7B6F9CDNqa3mnmQZpyokwAFdT4WEug&oe=6B00AF1E"
        },
        {
          "code": "DfxxIRDBnNJ",
          "pk": "4031219213812527945",
          "url": "https://www.instagram.com/reel/DfxxIRDBnNJ/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 852,
          "comment_count": 10,
          "play_count": 120660,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/897383659_18088617635510621_621705795789675145_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=11YpdP_7hC0Q7kNvwFddSuZ&_nc_oc=AdoWXALVjq6e5rNw2fw1iVN8CQdgbkEYwOgySA_OMAQkOOi9X3tGQMVirGZf3t1ma_g&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQ4AAAA&oh=00_AQRZikK726u1Uj7MHtnIpVdQ-Lnp8D0KMkemBJKRHwRmpQ&oe=6B00C029"
        },
        {
          "code": "DfvP0lahOUV",
          "pk": "4030509775803704597",
          "url": "https://www.instagram.com/reel/DfvP0lahOUV/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 293,
          "comment_count": 18,
          "play_count": 2320,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/898421037_2157377892320731_2939594704562919903_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=-tYmJ5VUrw4Q7kNvwHpJCN_&_nc_oc=AdoP03YWKdkNkNXp3qnYxxZNNQJldQtFN9q4f7njmzyMZFmEwLF0KB-j0TwQ-Ys3OWI&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQ55D74bH1hVMw7hokmrCQ3oLg1C0PwiztdhTUbPsIVhA&oe=6B00BEF5"
        },
        {
          "code": "DfsidWKhMjY",
          "pk": "4029747316834748632",
          "url": "https://www.instagram.com/reel/DfsidWKhMjY/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 70,
          "comment_count": 4,
          "play_count": 3106,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/896424510_18088616315510621_4250341777225889654_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=iTEo2AGtvNMQ7kNvwHe750q&_nc_oc=Ado8RgJ1qqdjZ_vnHFI6N1IOCxoyCCeTkearnDsdgJlz0PQv35qnJ7_d4_9nIdybX80&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQ4AAAA&oh=00_AQSDG3E_3vZ7gV5ejpssISPcuNy8HMWZ9UUh97Vg41i20w&oe=6B00BA6B"
        },
        {
          "code": "DfqD-nzBJTp",
          "pk": "4029050314115290345",
          "url": "https://www.instagram.com/reel/DfqD-nzBJTp/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 79,
          "comment_count": 3,
          "play_count": 1745,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-15/890616641_18088615757510621_7412439345795181090_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=xueV9y1RW9kQ7kNvwFyr2j2&_nc_oc=Ado_NBwnu82q72A9ef7pxBtn6v9HmG4IwwavnEm6hz-r8e769fpPrg_4IkH5b_SHtCQ&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQ4AAAA&oh=00_AQQnrUA9pTnEuZHXCvkWLeo3QcNPgN58HGe0WZEkN0zlyw&oe=6B00ABDA"
        },
        {
          "code": "Dfk7hWAhJxG",
          "pk": "4027605742893964358",
          "url": "https://www.instagram.com/reel/Dfk7hWAhJxG/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 55,
          "comment_count": 1,
          "play_count": 1770,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/856534748_18085155428510621_5955364233745298862_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=tDhitYUJFo4Q7kNvwFY1ybg&_nc_oc=AdrJ5R7Z0gTNzzscrDru5X4zyBVHxgkM4kkLt9TZWuq-ZfW5z9v-ES6BytkGs4d-HXI&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQJS0B4zqVF9xy7R2Oy-LcVloyYA64ev7HQ5Smh3ZeLEg&oe=6B00B0E2"
        },
        {
          "code": "DfiY8uTh-cY",
          "pk": "4026890742827312920",
          "url": "https://www.instagram.com/reel/DfiY8uTh-cY/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 34,
          "comment_count": 4,
          "play_count": 1070,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/860152996_1411862054387709_899624121882638327_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=C-PzqB0Cl54Q7kNvwH2Qao-&_nc_oc=AdqNFzf_eVmcLuyp-gUUQ9UtJDVMKhIXm5V-ShNWXEJJBU0bPMaLb9z2GgIO3C-8K2w&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQSxSPpwz5PeU5YG5S1UDrCpJT6v1YH-X0pfEwFpU3rLkg&oe=6B00D4C7"
        },
        {
          "code": "DffsJciB-Fx",
          "pk": "4026130755050004849",
          "url": "https://www.instagram.com/reel/DffsJciB-Fx/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 33,
          "comment_count": 1,
          "play_count": 1368,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-15/857367833_18085153877510621_3963890185175751170_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=v7btWITJy-8Q7kNvwEFRhSB&_nc_oc=AdqSvarjFyxtJvTpoQJ_SNJRXjJxlcKtQXQ69pwUjoUiFU0pjVtck8vPB3Unr78HXSw&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQSNPI_TwEbYE2dyIm785gLnmkIWdDE9ramCn_23QJAo0w&oe=6B00C9C9"
        },
        {
          "code": "DfdKQBOhlVV",
          "pk": "4025418723233256789",
          "url": "https://www.instagram.com/reel/DfdKQBOhlVV/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 149,
          "comment_count": 3,
          "play_count": 3534,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-2.cdninstagram.com/v/t51.71878-15/861834081_1470004301675686_7255715688488543766_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=mnR_JcWcReIQ7kNvwEhvKwq&_nc_oc=Adr7T2Fr43Qby7RKM8aItmRQEoPw2xFnDAoL1H9jqMMZmDMOk3iOXGPz6wn6K7E04Z4&_nc_zt=23&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQQnqtBO-2s6dus-OW4FelAjoPqgmv5rnlwlJsm_CeTQ6A&oe=6B00D0FE"
        },
        {
          "code": "DfX-XZQhYHR",
          "pk": "4023959078631211473",
          "url": "https://www.instagram.com/reel/DfX-XZQhYHR/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 65,
          "comment_count": 2,
          "play_count": 1428,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.71878-15/862620142_2182448292369481_1499216731697373159_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ycEoNyTevSUQ7kNvwH66p4X&_nc_oc=Adp8ti70WiXc4sViFW0s8KrAe89aX6NY2nroC4Hw_2pUVmPCbT-zVAX8pyaE6ZN_6IU&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQRzm5V4N-WOM43fHsPopy1jmTvX04TMCtucs-qpruOhww&oe=6B00BA30"
        },
        {
          "code": "DfVnWAjBttz",
          "pk": "4023294878355479411",
          "url": "https://www.instagram.com/reel/DfVnWAjBttz/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 100,
          "comment_count": 6,
          "play_count": 2115,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-3.cdninstagram.com/v/t51.71878-15/863871666_963233599715665_2136836762004690690_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=X6B_wotD-uwQ7kNvwH2mgtu&_nc_oc=Adp7CVK8WW-BDhJIjZP3HgjMqPOriDIbkev464c_gRYB8GqYjsP1cnNGa7h5BsXliug&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQRpmI7xqhLZdNFLW3zeCBsrqQHVWQe3AumN1QnbfBL0eg&oe=6B00AF23"
        },
        {
          "code": "DfS7pqQhi0a",
          "pk": "4022539764812360986",
          "url": "https://www.instagram.com/reel/DfS7pqQhi0a/",
          "taken_at": null,
          "user": {
            "pk": "45252998620",
            "id": "17841445318616624"
          },
          "like_count": 36,
          "comment_count": 3,
          "play_count": 1444,
          "caption": null,
          "has_audio": null,
          "size": [
            null,
            null
          ],
          "video_urls": [],
          "cover": "https://scontent-lga3-1.cdninstagram.com/v/t51.82787-15/863609232_18085154288510621_6627764684697588653_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=MVZVvfoAiogQ7kNvwG2D8vL&_nc_oc=AdozBc5Q-_6A8t2xFgAuwEJ19oLb98tJ-FTnkqMBUkSKDwSHfDJ7IJG_laxFYEL7qwc&_nc_zt=23&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=LeNTAFp-upk81Hv2vyntdQ&_nc_ss=7fa8c&_nc_ct=RQosPBUKFQQAAAA&oh=00_AQRgmtlTBzzF30p7E9MUCzV5WMDO_dW405eJiadGCAv13A&oe=6B00A79A"
        }
      ],
      "next_cursor": "AQHTS2nGUt-7QXO1WoYiMcmQrPUyo7z4QKqYTdD3FjscM4jwQn30j1xrGhzFrppL3SCZVHMLZPrZtXagXZyP5fl_Iw",
      "has_more": true
    }
  }
}

Billing

With the current configuration, each successful request costs 1 credit.

Every successful request, including empty results, is settled at the current database-configured rate. Failures are free. Sufficient balance is required before querying; insufficient balance during concurrent settlement returns 402 without delivering unsettled results. URL parsing adds no separate charge.

Status codes and errors

HTTPMeaning
200Success, including empty results
400Invalid JSON or parameters
401Invalid authentication
402Insufficient credits
429Rate limit; wait for Retry-After
502Data request failed
503API or pricing not configured
{"code":"invalid_params","message":"Invalid parameter"}