Instagram Post API
Read public Instagram post or Reel details, media, author and engagement.
Read public Instagram post or Reel details, media, author and engagement.
Open product page and API TesterEndpoint and authentication
POST https://api.goanyapi.com/api/v1/instagram/post/detailResults 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
| Parameter | Location | Type | Required | Default | Constraints and meaning |
|---|---|---|---|---|---|
| Authorization | Header | string | Yes | — | Bearer YOUR_API_KEY |
| Content-Type | Header | string | Yes | application/json | application/json |
| code | JSON body | string | Yes | — | Instagram shortcode or full https://www.instagram.com/p/<code>/ or /reel/<code>/ URL. URL parsing is local and adds no separate charge. Short links and other resource types are unsupported. maxLength=2048 |
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.
Instagram shortcode or full https://www.instagram.com/p/<code>/ or /reel/<code>/ URL. URL parsing is local and adds no separate charge. Short links and other resource types are unsupported.
Request example
POST /api/v1/instagram/post/detail
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"code": "https://www.instagram.com/reel/DfMyWK-hQFW/"
}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.
| Field | Type | Meaning |
|---|---|---|
| code | string | ok on success; error code otherwise |
| message | string | Status message |
| data.result | object / null | Business data; null is preserved |
| data.creditsUsed | integer | Credits charged using current configuration |
| data.remainingCredits | number | Balance after settlement |
| data.result.original_width | integer | Public business field; may be null, empty or absent |
| data.result.video_dash_manifest_len | integer | Public business field; may be null, empty or absent |
| data.result.code | string | Public business field; may be null, empty or absent |
| data.result.taken_at | integer | Public business field; may be null, empty or absent |
| data.result.like_count | integer | Public business field; may be null, empty or absent |
| data.result.clips_metadata | object | Public business field; may be null, empty or absent |
| data.result.clips_metadata.music_info | null (observed) | Public business field; may be null, empty or absent |
| data.result.clips_metadata.original_sound_info | object | Public business field; may be null, empty or absent |
| data.result.clips_metadata.original_sound_info.consumption_info | object | Public business field; may be null, empty or absent |
| data.result.clips_metadata.original_sound_info.consumption_info.should_mute_audio_reason_type | null (observed) | Public business field; may be null, empty or absent |
| data.result.has_audio | boolean | Public business field; may be null, empty or absent |
| data.result.id | string | Public business field; may be null, empty or absent |
| data.result.caption | string | Public business field; may be null, empty or absent |
| data.result.comment_count | integer | Public business field; may be null, empty or absent |
| data.result.original_height | integer | Public business field; may be null, empty or absent |
| data.result.pk | string | Public business field; may be null, empty or absent |
| data.result.video_versions | array | Public business field; may be null, empty or absent |
| data.result.video_versions[].url | string | Public business field; may be null, empty or absent |
| data.result.video_versions[].height | null (observed) | Public business field; may be null, empty or absent |
| data.result.video_versions[].type | integer | Public business field; may be null, empty or absent |
| data.result.video_versions[].mimeType | null (observed) | Public business field; may be null, empty or absent |
| data.result.video_versions[].width | null (observed) | Public business field; may be null, empty or absent |
| data.result.number_of_qualities | integer | Public business field; may be null, empty or absent |
| data.result.is_dash_eligible | integer | Public business field; may be null, empty or absent |
| data.result.image_versions2_candidates | array | Public business field; may be null, empty or absent |
| data.result.image_versions2_candidates[].height | null (observed) | Public business field; may be null, empty or absent |
| data.result.image_versions2_candidates[].width | null (observed) | Public business field; may be null, empty or absent |
| data.result.image_versions2_candidates[].url | string | Public business field; may be null, empty or absent |
| data.result.user | object | Public business field; may be null, empty or absent |
| data.result.user.username | string | Public business field; may be null, empty or absent |
| data.result.user.profile_pic_url | string | Public business field; may be null, empty or absent |
| data.result.user.pk | string | Public business field; may be null, empty or absent |
This endpoint has no pagination parameters.
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": {
"pk": "4020809993275375958",
"id": "POLARIS_4020809993275375958",
"code": "DfMyWK-hQFW",
"taken_at": 1793538007,
"original_width": 1080,
"original_height": 1920,
"user": {
"pk": "61117905602",
"username": "realchinesewithluella",
"profile_pic_url": "https://scontent-sjc3-1.cdninstagram.com/v/t51.82787-19/777916394_17988995619033603_2664203103875575616_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ig_cache_key=GOoPXi4DEr1t5eg-AEAv-3_bJvkkbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=oGRs_-y3zEcQ7kNvwHhRLAN&_nc_oc=AdqOQfpKcweh99yG3MPGDhSmbL36b2408kjJARFlD0kCWFLkAe-QWjX4-ZqI9s15bmg&_nc_zt=24&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_ct=RQosPBUCFQIAAAA&oh=00_AQSpwQKZNG2KAsh3G64t5VUIxXBSVcaXq6OFtBG1dzdP9w&oe=6B004254"
},
"like_count": 10923,
"comment_count": 30,
"has_audio": true,
"is_dash_eligible": 1,
"number_of_qualities": 4,
"caption": "#chinese #chineselanguage #chineselearning #mandarin #funny",
"clips_metadata": {
"music_info": null,
"original_sound_info": {
"consumption_info": {
"should_mute_audio_reason_type": null
}
}
},
"video_versions": [
{
"type": 101,
"width": null,
"height": null,
"mimeType": null,
"url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPj6Ix0c5tmDjveAaM-j4V2-cvdBm_8Z0t6wQ5Sgb5DhgxSpuEuNmwaArDxtWdvSc4_LSfMOk0L3scXJLl0gDPzRjTtPSC-lF_W96w.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=i_5hnFwSeJ4Q7kNvwG9ngBX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjIxMDAwMDc5OTk0Mzc4MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=d14f9f4ce41bc51b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzFBMEI1Q0QxMUE0MDc3OThCODg0RjY2QzdBREQ0Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0NEMTExM0VDM0VDNDQ0QTg4MzhDMzFBRjM3RUU5OTIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwOIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRJjb3B5X3NhbXBsZV9ncm91cHMBMRUAACbIsZKK_f7sBxUCKAJDMywXQCi7ZFocrAgYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQSETog8oEJPW6s3Pv-c0gOs1we_W2GvqpPIeAJoBIGp5Q&oe=6AFC515C"
},
{
"type": 102,
"width": null,
"height": null,
"mimeType": null,
"url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPj6Ix0c5tmDjveAaM-j4V2-cvdBm_8Z0t6wQ5Sgb5DhgxSpuEuNmwaArDxtWdvSc4_LSfMOk0L3scXJLl0gDPzRjTtPSC-lF_W96w.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=i_5hnFwSeJ4Q7kNvwG9ngBX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjIxMDAwMDc5OTk0Mzc4MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=d14f9f4ce41bc51b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzFBMEI1Q0QxMUE0MDc3OThCODg0RjY2QzdBREQ0Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0NEMTExM0VDM0VDNDQ0QTg4MzhDMzFBRjM3RUU5OTIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwOIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRJjb3B5X3NhbXBsZV9ncm91cHMBMRUAACbIsZKK_f7sBxUCKAJDMywXQCi7ZFocrAgYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQSETog8oEJPW6s3Pv-c0gOs1we_W2GvqpPIeAJoBIGp5Q&oe=6AFC515C"
},
{
"type": 103,
"width": null,
"height": null,
"mimeType": null,
"url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPj6Ix0c5tmDjveAaM-j4V2-cvdBm_8Z0t6wQ5Sgb5DhgxSpuEuNmwaArDxtWdvSc4_LSfMOk0L3scXJLl0gDPzRjTtPSC-lF_W96w.mp4?_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=i_5hnFwSeJ4Q7kNvwG9ngBX&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjIxMDAwMDc5OTk0Mzc4MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=d14f9f4ce41bc51b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzFBMEI1Q0QxMUE0MDc3OThCODg0RjY2QzdBREQ0Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0NEMTExM0VDM0VDNDQ0QTg4MzhDMzFBRjM3RUU5OTIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwOIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRJjb3B5X3NhbXBsZV9ncm91cHMBMRUAACbIsZKK_f7sBxUCKAJDMywXQCi7ZFocrAgYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQSETog8oEJPW6s3Pv-c0gOs1we_W2GvqpPIeAJoBIGp5Q&oe=6AFC515C"
}
],
"image_versions2_candidates": [
{
"width": null,
"height": null,
"url": "https://scontent-sjc6-1.cdninstagram.com/v/t51.71878-15/852558649_1459559266272163_6328943251903360248_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAyMDgwOTk5MzI3NTM3NTk1OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fZmlyc3RfZnJhbWVfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=VQuJdGcbgpYQ7kNvwGvKfB_&_nc_oc=AdriaMpRMbLsub_SgE_VD3ZRrXVkQajAxTlJ2Vc5pyo7CyVg-4wfXoD1NLlljcDaQyo&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_ct=RQosPBUIFQolBAAAAA&oh=00_AQQTAv4Zm8l0tTLn_I66Er3zqmf5Ra_0FjACiC9gLdkXdQ&oe=6B0041C6"
},
{
"width": null,
"height": null,
"url": "https://scontent-sjc6-1.cdninstagram.com/v/t51.71878-15/852558649_1459559266272163_6328943251903360248_n.jpg?stp=dst-jpg_e15_p480x480_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAyMDgwOTk5MzI3NTM3NTk1OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fZmlyc3RfZnJhbWVfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=VQuJdGcbgpYQ7kNvwGvKfB_&_nc_oc=AdriaMpRMbLsub_SgE_VD3ZRrXVkQajAxTlJ2Vc5pyo7CyVg-4wfXoD1NLlljcDaQyo&_nc_zt=23&_nc_ht=scontent-sjc6-1.cdninstagram.com&_nc_gid=JxaBj4rPKXXgpwCzsYua8Q&_nc_ss=78689&_nc_ct=RQosPBUIFQolBAAAAA&oh=00_AQTCDoClPZmAOMlXtx9M8OCIH4_ZGt4bAg2bxbo0B4gORA&oe=6B0041C6"
}
],
"video_dash_manifest_len": 9393
}
}
}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
| HTTP | Meaning |
|---|---|
| 200 | Success, including empty results |
| 400 | Invalid JSON or parameters |
| 401 | Invalid authentication |
| 402 | Insufficient credits |
| 429 | Rate limit; wait for Retry-After |
| 502 | Data request failed |
| 503 | API or pricing not configured |
{"code":"invalid_params","message":"Invalid parameter"}