{"openapi":"3.2.0","info":{"title":"Instagram post reel story follower comment etc API","description":"The InstantPeer Instagram Data API provides fast, reliable, and real-time public data extraction from Instagram without account login requirements. Powered by a decentralized residential peer-node network, our API bypasses IP bans and aggressive platform rate limits to deliver high availability.","version":"1.0.0"},"servers":[{"url":"https://ig-ipeerapis.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Search"},{"name":"Comments"},{"name":"User"},{"name":"Media"},{"name":"Relationships"},{"name":"Highlights"}],"x-agent-commerce":{"catalog_url":"https://ig-ipeerapis.jojapi.net/_jojapi/agent/plans","discovery_url":"https://ig-ipeerapis.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/instagram-data-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/v1/search_hashtag.php":{"get":{"operationId":"get_v1_search_hashtag_php","summary":"searchHashtag","description":"Retrieve hashtag metadata header and a feed of recent/top posts tagged with the hashtag.","tags":["Search"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Hashtag details and recent posts.","properties":{"hashtag_info":{"type":"object","description":"Metadata describing the hashtag.","properties":{"id":{"type":"string","description":"Numeric or string identifier of the hashtag."},"name":{"type":"string","description":"Hashtag name without the leading # symbol."},"media_count":{"type":"integer","description":"Total count of public media tagged with this hashtag."},"profile_pic_url":{"type":"string","description":"URL of the hashtag profile picture or representative cover image."}},"required":["id","name","media_count","profile_pic_url"]},"posts":{"type":"array","items":{"type":"object","description":"Instagram feed post details.","properties":{"id":{"type":"string","description":"Unique compound Instagram media ID."},"pk":{"type":"string","description":"Numeric media primary key identifier."},"code":{"type":"string","description":"Shortcode of the post used in URL instagram.com/p/{code}/."},"caption":{"type":"string","description":"Post caption text."},"like_count":{"type":"integer","description":"Total number of likes on the post."},"comment_count":{"type":"integer","description":"Total number of comments on the post."},"media_type":{"type":"string","enum":["image","video"],"description":"Type of media ('image' or 'video')."},"display_url":{"type":"string","description":"Direct URL of the image or video thumbnail."},"video_url":{"type":"string","description":"Direct video stream URL if media_type is video, otherwise empty string."},"taken_at":{"type":"integer","format":"int64","description":"Unix epoch timestamp when the post was published.","minimum":-9223372036854776000,"maximum":9223372036854776000}},"required":["id","pk","code","caption","like_count","comment_count","media_type","display_url","video_url","taken_at"]}},"pagination_token":{"type":["string","null"],"description":"Cursor token for retrieving the next page of posts."}},"required":["hashtag_info","posts"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"hashtag_info":{"id":"17843826134072230","name":"funnymeme","media_count":124500,"profile_pic_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.82787-15/831424339_18085502594329798_4323115522535743803_n.jpg"},"posts":[{"id":"4001866158142201707_39953281797","pk":"4001866158142201707","code":"DeJfBFquR9r","caption":"Kya sher palak methi khata hai ? 🤣🤣\n#viral #funnymeme #funnyreels #reelitfeelit #myth","like_count":61273,"comment_count":360,"media_type":"video","display_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.82787-15/831424339_18085502594329798_4323115522535743803_n.jpg","video_url":"https://instagram.famd5-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOmAyrbyoL_Rf-07WGlCw2jzyVMy5fhsI_-Oswm5YVIdT2jX_3vYM5RwlFVC7uhBAokCxi86KwRlnjCBOGneSsMgGKaJTzCcXznba0.mp4","taken_at":1791392222}],"pagination_token":"eJwBCQH2/hsBXAAa9hjW/cirrYS+iW+gj7Tjhd2tjm+eq+XUk7ysi2+w4Na08b7/12LW6u2EmrLT7W7qnuSr08fYvFfCz++E2Zehj2+Av8PsgcfWnW7ymImzkvW7xG7euNqMiuO4ym2iqafot4LMrG6ihKe7/p7IlG+Mz9+8pO/ojm/en5yZw4Wa12jCz4TCzOvNoW3Ku6eDsa/n8m6Yl7zrmuLAg2/UgJe7lNyN8m72+uiEy5+rhW7Ij+CY+NKu1mrst/e5qJbfyTre9Y+iuIaTmG6aueD849DD6W6E+a+4zpmo9W4YJGRhMjExNWIwLTNmODAtNGU2ZC05YTNjLWM4MDI1ZGU4NDdkMwAUAADshaHS"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"hashtag","in":"query","description":"Hashtag name with or without leading # (e.g. funnymeme or #funnymeme).","required":true,"schema":{"type":"string","example":"funnymeme"}},{"name":"pagination_token","in":"query","description":"Pagination cursor token returned by previous page request.","required":false,"schema":{"type":"string","example":"eJwBCQH2/hsBXAAa9hjW/cirrYS+iW+gj7Tjhd2tjm+eq+XUk7ysi2+w4Na08b7/12LW6u2EmrLT7W7qnuSr08fYvFfCz++E2Zehj2+Av8PsgcfWnW7ymImzkvW7xG7euNqMiuO4ym2iqafot4LMrG6ihKe7/p7IlG+Mz9+8pO/ojm/en5yZw4Wa12jCz4TCzOvNoW3Ku6eDsa/n8m6Yl7zrmuLAg2/UgJe7lNyN8m72+uiEy5+rhW7Ij+CY+NKu"}}]}},"/v1/search_ig.php":{"get":{"operationId":"get_v1_search_ig_php","summary":"searchIg","description":"Search across Instagram users, hashtags, and places.","tags":["Search"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"pk":{"type":"string"},"username":{"type":"string"}},"required":["id","pk","username"]}},"hashtags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"media_count":{"type":"integer"}},"required":["id","name","media_count"]}},"places":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"lat":{"type":"number","format":"double","minimum":-1.7976931348623157e+308,"maximum":1.7976931348623157e+308},"lng":{"type":"number","format":"double","minimum":-1.7976931348623157e+308,"maximum":1.7976931348623157e+308}},"required":["id","name","address","city","lat","lng"]}}},"required":["users","hashtags","places"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"users":[{"id":"42657730082","pk":"42657730082","username":"iamnanapatekar","full_name":"Nana Patekar","profile_pic_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.2885-19/120313696_191627629192605_8575059422175502937_n.jpg","is_verified":true,"is_private":false},{"id":"4770323370","pk":"4770323370","username":"nanabhai_lalbhai_kapadwala","full_name":"Shree nanabhai lalbhai Kapadia","profile_pic_url":"https://instagram.famd5-2.fna.fbcdn.net/v/t51.2885-19/34592128_192796284877338_340660867295084544_n.jpg","is_verified":false,"is_private":false}],"hashtags":[],"places":[]}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"search_query","in":"query","description":"Search keyword or query string.","required":true,"schema":{"type":"string","example":"nana"}}]}},"/v1/get_post_child_comments.php":{"get":{"operationId":"get_v1_get_post_child_comments_php","summary":"getPostChildComments","description":"Retrieve threaded reply comments under a specific parent comment with pagination support.","tags":["Comments"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Threaded reply comments for a specific parent comment.","properties":{"status":{"type":"string"},"parent_comment_id":{"type":"string","description":"Numeric ID string of the parent comment being replied to."},"total_replies":{"type":["integer","null"],"description":"Total count of threaded replies under this parent comment."},"child_comments":{"type":"array","description":"List of threaded reply comments.","items":{"type":"object","description":"Instagram comment details.","properties":{"id":{"type":"string","description":"Comment unique identifier."},"pk":{"type":"string","description":"Comment numeric primary key string."},"text":{"type":"string","description":"Comment body text."},"created_at":{"type":"integer","format":"int64","description":"Unix epoch timestamp (seconds) when comment was published.","minimum":-9223372036854776000,"maximum":9223372036854776000},"like_count":{"type":"integer","description":"Number of likes on this comment."},"child_comment_count":{"type":"integer","description":"Number of threaded reply comments."},"user":{"type":"object","description":"Author of an Instagram comment.","properties":{"id":{"type":"string","description":"Numeric user ID string."},"pk":{"type":"string","description":"Numeric user primary key string."},"username":{"type":"string","description":"Instagram username."},"full_name":{"type":"string","description":"User's full display name."},"profile_pic_url":{"type":"string","description":"Direct URL of user profile picture avatar."},"is_verified":{"type":"boolean","description":"Whether the comment author is a verified account."},"is_private":{"type":"boolean","description":"Whether the comment author account is private."}},"required":["id","pk","username","full_name","profile_pic_url","is_verified","is_private"]}},"required":["id","pk","text","created_at","like_count","child_comment_count","user"]}},"pagination_token":{"type":["string","null"],"description":"Pagination cursor token to fetch the next batch of replies. Null or omitted when on the last page."}},"required":["status","parent_comment_id","child_comments"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"status":"success","parent_comment_id":"18115514723519382","total_replies":25,"child_comments":[{"id":"17873039223639869","pk":"17873039223639869","text":"He's the King of New india. U r Andhbhakt of BJP","created_at":1791722547,"like_count":8,"child_comment_count":0,"user":{"id":"51520926785","pk":"51520926785","username":"still_imagination","full_name":"Someday May Be","profile_pic_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.2885-19/273245387_507366054081841_2983955176815452817_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=106&ccb=7-5","is_verified":false,"is_private":true}}],"pagination_token":"AQHTEz940cAsqj1dMfMNjiZA0Vj0ShRfmqDu_KryBSdzUMK-1HkSlePzwEvgb2lHtSO-HDXQ_RE3HyROOcs1p3kHuA"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"pagination_token","in":"query","description":"Pagination token cursor to fetch the next batch of replies.","required":false,"schema":{"type":"string","example":"AQHTEz940cAsqj1dMfMNjiZA0Vj0ShRfmqDu_KryBSdzUMK-1HkSlePzwEvgb2lHtSO-HDXQ_RE3HyROOcs1p3kHuA"}},{"name":"comment_id","in":"query","description":"Parent comment ID to fetch replies for.","required":true,"schema":{"type":"string","example":"18115514723519382"}},{"name":"post_id","in":"query","description":"Instagram post or reel shortcode (e.g. DeWq4dZlEGO), numeric media ID, or full post URL.","required":false,"schema":{"type":"string","example":"4005577516404457870"}}]}},"/v1/get_post_comments.php":{"get":{"operationId":"get_v1_get_post_comments_php","summary":"getPostComments","description":"Retrieve top-level comments for a post, reel, or carousel media with pagination support.","tags":["Comments"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Top-level comments response for a post or reel.","properties":{"status":{"type":"string"},"total_count":{"type":["integer","null"],"description":"Total comment count on the media post."},"comments":{"type":"array","description":"List of top-level comments.","items":{"type":"object","description":"Instagram comment details.","properties":{"id":{"type":"string","description":"Comment unique identifier."},"pk":{"type":"string","description":"Comment numeric primary key string."},"text":{"type":"string","description":"Comment body text."},"created_at":{"type":"integer","format":"int64","description":"Unix epoch timestamp (seconds) when comment was published.","minimum":-9223372036854776000,"maximum":9223372036854776000},"like_count":{"type":"integer","description":"Number of likes on this comment."},"child_comment_count":{"type":"integer","description":"Number of threaded reply comments."},"user":{"type":"object","description":"Author of an Instagram comment.","properties":{"id":{"type":"string","description":"Numeric user ID string."},"pk":{"type":"string","description":"Numeric user primary key string."},"username":{"type":"string","description":"Instagram username."},"full_name":{"type":"string","description":"User's full display name."},"profile_pic_url":{"type":"string","description":"Direct URL of user profile picture avatar."},"is_verified":{"type":"boolean","description":"Whether the comment author is a verified account."},"is_private":{"type":"boolean","description":"Whether the comment author account is private."}},"required":["id","pk","username","full_name","profile_pic_url","is_verified","is_private"]}},"required":["id","pk","text","created_at","like_count","child_comment_count","user"]}},"pagination_token":{"type":["string","null"],"description":"Pagination cursor token to retrieve the next batch of comments. Null or omitted when on the last page."}},"required":["status","comments"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"status":"success","total_count":153,"comments":[{"id":"18129317792505899","pk":"18129317792505899","text":"🔥🙌","created_at":1791722112,"like_count":1,"child_comment_count":0,"user":{"id":"45132809495","pk":"45132809495","username":"simran__gupta_01_","full_name":"Simran Gupta","profile_pic_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.82787-19/730381895_18060584618505496_4234992205944414095_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=7-5","is_verified":false,"is_private":false}},{"id":"18090358568453909","pk":"18090358568453909","text":"Justice must prevail! 🙏","created_at":1791721980,"like_count":4,"child_comment_count":2,"user":{"id":"43541157908","pk":"43541157908","username":"iam.sonisinghh","full_name":"Soni Singh","profile_pic_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.82787-19/829310835_18090358568453909_1868400108087778405_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5","is_verified":false,"is_private":false}}],"pagination_token":"{\"cached_comments_cursor\":\"17970064923188307\"}"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"media_id","in":"query","description":"Numeric media ID (e.g. 4005577516404457870). Optional alternative to media_code.","required":false,"schema":{"type":"string","example":"4005577516404457870"}},{"name":"media_code","in":"query","description":"Instagram post or reel media code (e.g. DeWq4dZlEGO).","required":true,"schema":{"type":"string","example":"DeWq4dZlEGO"}},{"name":"pagination_token","in":"query","description":"Pagination token cursor to fetch the next batch of comments.","required":false,"schema":{"type":"string","example":"AQHTEz940cAsqj1dMfMNjiZA0Vj0ShRfmqDu_KryBSdzUMK"}}]}},"/v1/get_ig_user_posts.php":{"get":{"operationId":"get_v1_get_ig_user_posts_php","summary":"getUserPosts","description":"Retrieve paginated feed posts published by the given Instagram user.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Paginated list of user feed posts.","properties":{"posts":{"type":"array","description":"List of published feed posts.","items":{"type":"object","description":"Instagram feed post details.","properties":{"id":{"type":"string","description":"Unique compound Instagram media ID."},"pk":{"type":"string","description":"Numeric media primary key identifier."},"code":{"type":"string","description":"Shortcode of the post used in URL instagram.com/p/{code}/."},"caption":{"type":"string","description":"Post caption text."},"like_count":{"type":"integer","description":"Total number of likes on the post."},"comment_count":{"type":"integer","description":"Total number of comments on the post."},"media_type":{"type":"string","enum":["image","video"],"description":"Type of media ('image' or 'video')."},"display_url":{"type":"string","description":"Direct URL of the image or video thumbnail."},"video_url":{"type":"string","description":"Direct video stream URL if media_type is video, otherwise empty string."},"taken_at":{"type":"integer","format":"int64","description":"Unix epoch timestamp when the post was published.","minimum":-9223372036854776000,"maximum":9223372036854776000}},"required":["id","pk","code","caption","like_count","comment_count","media_type","display_url","video_url","taken_at"]}},"pagination_token":{"type":["string","null"],"description":"Pagination cursor token for retrieving the next batch of posts. Null or omitted if no further pages exist."}},"required":["posts"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"posts":[{"id":"4001888828050089811_4823648870","pk":"4001888828050089811","code":"DeJkK-qh6dT","caption":"Miss you 😭😭😭 gujju bhai 😭😭 તમારા જેવો પ્રેમ કોઈ ના કરી શકે 😭","like_count":1754,"comment_count":14,"media_type":"video","display_url":"https://instagram.fstv8-2.fna.fbcdn.net/v/t51.82787-15/835950483_18392497108160871_8130746787046693385_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=101&ccb=7-5","video_url":"https://instagram.fstv8-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQNE3wZDRzlR1BsLpSgoZkHoylD7midnTfL4r42-ElNFUBoO-TFPOACOho.mp4?_nc_cat=107","taken_at":1791282447}],"pagination_token":"AQHTT9MQQYhbjBes7wBGWKTTqpFs82WOSqsUHMXXwaQET3gIsM3ELQsgnuPD3VAqfcu6uo6XikJ6h34XtREJW51-fw"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"username","in":"query","description":"Target Instagram username without @ or URL prefix.","required":true,"schema":{"type":"string","example":"prakash_mandora_official"}},{"name":"pagination_token","in":"query","description":"Pagination cursor token to fetch the next batch of posts.","required":false,"schema":{"type":"string","example":"AQHTT9MQQYhbjBes7wBGWKTTqpFs82WOSqsUHMXXwaQET3gIsM3ELQsgnuPD3VAqfcu6uo6XikJ6h34XtREJW51-fw"}}]}},"/v1/get_ig_user_stories.php":{"get":{"operationId":"get_v1_get_ig_user_stories_php","summary":"getUserStories","description":"Retrieve currently active 24-hour stories published by the specified user.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Active 24-hour stories published by the user.","properties":{"stories":{"type":"array","description":"List of currently active story items.","items":{"type":"object","description":"Individual active story media item.","properties":{"id":{"type":"string","description":"Compound story media ID formatted as {pk}_{user_id}."},"pk":{"type":"string","description":"Unique numeric media ID string."},"code":{"type":"string","description":"Story shortcode."},"caption":{"type":"string","description":"Story caption text if present, or empty string."},"media_type":{"type":"string","description":"Media type identifier ('video' or 'image')."},"display_url":{"type":"string","description":"Thumbnail / frame image URL."},"video_url":{"type":"string","description":"Direct video stream URL if media is a video, or empty string."},"has_audio":{"type":"boolean","description":"Indicates whether the story has audio / sound."},"taken_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds) when the story was published.","minimum":-9223372036854776000,"maximum":9223372036854776000},"expiring_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds) when the story expires (24h after publication).","minimum":-9223372036854776000,"maximum":9223372036854776000},"user":{"type":"object","description":"User information of the story publisher.","properties":{"id":{"type":"string","description":"Numeric Instagram user ID."},"username":{"type":"string","description":"Instagram username."},"profile_pic_url":{"type":"string","description":"URL to the user's profile avatar."}},"required":["id","username","profile_pic_url"]},"music_info":{"type":"object","description":"Background music sticker attached to the story.","properties":{"title":{"type":"string","description":"Music track title."},"display_artist":{"type":"string","description":"Music artist display name."}},"required":["title","display_artist"]}},"required":["id","pk","code","caption","media_type","display_url","video_url","has_audio","taken_at","expiring_at","user"]}}},"required":["stories"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"stories":[{"id":"4001732126680057423_4823648870","pk":"4001732126680057423","code":"DeJAirJCIZP","caption":"","media_type":"video","display_url":"https://instagram.fstv8-3.fna.fbcdn.net/v/t51.71878-15/837632407_1497898692174560_2223445088879398274_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&ccb=7-5","video_url":"https://instagram.fstv8-3.fna.fbcdn.net/o1/v/t2/f2/m78/AQONd3fXdnEYABOHHFWP7Px-XRCrPchhj3dB6SA7ZkftLc4JhdXdYuYRnJ2fo3Y009WctGVWAmQZi82IlJGFlCvTOp5wHB34K6eeJF8.mp4?_nc_cat=104&ccb=17-1","has_audio":true,"taken_at":1791263674,"expiring_at":1791350074,"user":{"id":"4823648870","username":"prakash_mandora_official","profile_pic_url":"https://instagram.fstv8-1.fna.fbcdn.net/v/t51.2885-19/273422501_915366472508587_8108737757898234220_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=107&ccb=7-5"},"music_info":{"title":"Its Magic","display_artist":"Taz (Stereo Nation)"}}]}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 4823648870).","required":true,"schema":{"type":"string","example":"4823648870"}}]}},"/v1/get_ig_user_id.php":{"get":{"operationId":"get_v1_get_ig_user_id_php","summary":"getUserId","description":"Resolve an Instagram username or profile URL to its numeric user ID.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"username":{"type":"string"},"user_id":{"type":"string"}},"required":["username","user_id"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"username":"cristiano","user_id":"173560420"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"username","in":"query","description":"Instagram username (e.g. cristiano) or profile URL.","required":true,"schema":{"type":"string","example":"cristiano"}}]}},"/v1/get_ig_user_about.php":{"get":{"operationId":"get_v1_get_ig_user_about_php","summary":"getUserAbout","description":"Retrieve account transparency details including date joined, country of account creation, verification status, and active ads.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Account transparency and about information.","properties":{"date_joined":{"type":"string","description":"Month and year when the account was created."},"verified_on":{"type":"string","description":"Verification status or date verified."},"creation_country":{"type":"string","description":"Country where the account was registered or created."},"active_ads":{"type":"string","description":"Whether the account currently has active advertisements running."},"no_of_accounts_with_shared_followers":{"type":"string","description":"Number of accounts with shared followers, if available."},"no_of_former_usernames":{"type":"string","description":"Count or list of former usernames changes, if available."}},"required":["date_joined","verified_on","creation_country","active_ads","no_of_accounts_with_shared_followers","no_of_former_usernames"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"date_joined":"February 2012","verified_on":"Verified","creation_country":"United States","active_ads":"No","no_of_accounts_with_shared_followers":"","no_of_former_usernames":""}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"username","in":"query","description":"Instagram username (e.g. cristiano) or profile URL.","required":true,"schema":{"type":"string","example":"cristiano"}}]}},"/v1/get_ig_user_reels.php":{"get":{"operationId":"get_v1_get_ig_user_reels_php","summary":"getUserReels","description":"Retrieve paginated Reels videos published by the specified user.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Paginated list of user reels videos.","properties":{"reels":{"type":"array","description":"List of published reels.","items":{"type":"object","description":"Individual Instagram Reel video item.","properties":{"id":{"type":"string","description":"Compound media ID formatted as {pk}_{user_id}."},"pk":{"type":"string","description":"Unique numeric media ID string."},"code":{"type":"string","description":"Reel shortcode used in Instagram URLs (/reel/{code}/)."},"caption":{"type":"string","description":"Reel caption text if available, or empty string if omitted by the tab feed."},"play_count":{"type":"integer","description":"Number of video plays."},"like_count":{"type":"integer","description":"Number of likes on the reel."},"comment_count":{"type":"integer","description":"Number of comments on the reel."},"media_type":{"type":"string","description":"Media type identifier ('video')."},"display_url":{"type":"string","description":"Thumbnail / cover image URL for the reel."},"video_url":{"type":"string","description":"Direct video stream URL if available, or empty string."},"video_duration":{"type":"number","format":"double","description":"Video duration in seconds.","minimum":-1.7976931348623157e+308,"maximum":1.7976931348623157e+308},"taken_at":{"type":"integer","format":"int64","description":"Unix timestamp (seconds) when the reel was posted, or 0 if omitted by the tab query.","minimum":-9223372036854776000,"maximum":9223372036854776000}},"required":["id","pk","code","caption","play_count","like_count","comment_count","media_type","display_url","video_url","video_duration","taken_at"]}},"pagination_token":{"type":["string","null"],"description":"Pagination cursor token for retrieving the next batch of reels. Null or omitted if no further pages exist."}},"required":["reels"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"reels":[{"id":"3989637083470928407_9123170068","pk":"3989637083470928407","code":"DdeCcoXApoX","caption":"Surat special street food experience! 🍲✨ #suratfood #reels","play_count":3147097,"like_count":54464,"comment_count":235,"media_type":"video","display_url":"https://instagram.famd5-2.fna.fbcdn.net/v/t51.82787-15/791129814_18268637968306069_2706029272782224540_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=107&ccb=7-5","video_url":"https://instagram.famd5-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQN_example_reel_video.mp4","video_duration":15.4,"taken_at":1791282447}],"pagination_token":"AQHTrTNo5aPJt0YlpQ-dpOvl5X_V-l0sQj0WeAnXSt_yPGvZANjXW0HMwiizuFAxnj9i6_0Uy32wjPO0OzWcFrlopQ"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"pagination_token","in":"query","description":"Pagination cursor token to fetch the next batch of reels.","required":false,"schema":{"type":"string","example":"AQHTrTNo5aPJt0YlpQ-dpOvl5X_V-l0sQj0WeAnXSt_yPGvZANjXW0HMwiizuFAxnj9i6_0Uy32wjPO0OzWcFrlopQ"}},{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 9123170068).","required":true,"schema":{"type":"string","example":"9123170068"}}]}},"/v1/get_ig_user_tagged_posts.php":{"get":{"operationId":"get_v1_get_ig_user_tagged_posts_php","summary":"getUserTaggedPosts","description":"Retrieve paginated feed posts where the specified user is tagged.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Paginated list of posts where the specified user is tagged.","properties":{"tagged_posts":{"type":"array","description":"List of tagged feed posts.","items":{"type":"object","description":"Instagram post where the specified user is tagged.","properties":{"id":{"type":"string","description":"Unique compound media ID."},"pk":{"type":"string","description":"Numeric media primary key identifier."},"code":{"type":"string","description":"Shortcode of the post used in URL instagram.com/p/{code}/."},"caption":{"type":"string","description":"Post caption text."},"like_count":{"type":"integer","description":"Total number of likes on the tagged post."},"comment_count":{"type":"integer","description":"Total number of comments on the tagged post."},"media_type":{"type":"string","description":"Instagram media type numeric code as string (1 for photo, 2 for video/clips, 8 for album)."},"display_url":{"type":"string","description":"Direct URL of the image or video thumbnail."},"video_url":{"type":"string","description":"Direct video stream URL if available, otherwise empty string."},"taken_at":{"type":"integer","format":"int64","description":"Unix epoch timestamp when the post was published, or 0 if omitted by GraphQL.","minimum":-9223372036854776000,"maximum":9223372036854776000},"owner":{"type":"object","description":"Author / publisher of the post where target user is tagged.","properties":{"id":{"type":"string","description":"Numeric user ID of the post author."},"username":{"type":"string","description":"Username of the post author."}},"required":["id","username"]}},"required":["id","pk","code","caption","like_count","comment_count","media_type","display_url","video_url","taken_at","owner"]}},"pagination_token":{"type":["string","null"],"description":"Pagination cursor token for retrieving the next batch of posts. Null or omitted if no further pages exist."}},"required":["tagged_posts"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"tagged_posts":[{"id":"3961210175091870316_9123170068","pk":"3961210175091870316","code":"Db5C6q3A4ps","caption":"80th independence Day Special Offer Belgian Hot Chocolate for just ₹99 on 15th August only! ☕✨","like_count":809,"comment_count":2,"media_type":"2","display_url":"https://instagram.fraj3-2.fna.fbcdn.net/v/t51.82787-15/770956174_18263371981306069_6638430997762888855_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&ccb=7-5","video_url":"","taken_at":0,"owner":{"id":"9123170068","username":"surti_lalo"}}],"pagination_token":"3835332562495740538"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 9123170068).","required":true,"schema":{"type":"string","example":"9123170068"}},{"name":"pagination_token","in":"query","description":"Pagination cursor token to fetch the next batch of tagged posts.","required":false,"schema":{"type":"string","example":"3835332562495740538"}}]}},"/v1/get_ig_similar_accounts.php":{"get":{"operationId":"get_v1_get_ig_similar_accounts_php","summary":"getSimilarAccounts","description":"Retrieve Instagram account recommendations similar to the specified user.","tags":["User"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Suggested / similar Instagram accounts related to the target user.","properties":{"users":{"type":"array","description":"List of suggested similar user accounts.","items":{"type":"object","description":"Individual suggested similar Instagram account.","properties":{"id":{"type":"string","description":"Numeric Instagram user ID string."},"pk":{"type":"string","description":"Numeric Instagram user PK string."},"username":{"type":"string","description":"Instagram handle / username."},"full_name":{"type":"string","description":"Full display name of the account."},"profile_pic_url":{"type":"string","description":"Profile avatar image URL."},"is_verified":{"type":"boolean","description":"Indicates whether the account has a verified badge."},"is_private":{"type":"boolean","description":"Indicates whether the account is private."}},"required":["id","pk","username","full_name","profile_pic_url","is_verified","is_private"]}}},"required":["users"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"users":[{"id":"45639430513","pk":"45639430513","username":"surbhi_fashion_sf","full_name":"🌸 surbhi fashion 🌸","profile_pic_url":"https://instagram.famd5-4.fna.fbcdn.net/v/t51.82787-19/587653449_18067621523526514_6127059542362989101_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=101&ccb=7-5","is_verified":true,"is_private":false},{"id":"58037077143","pk":"58037077143","username":"noor__ladies_wear","full_name":"Noor Ladies wear & Children wear","profile_pic_url":"https://instagram.famd5-5.fna.fbcdn.net/v/t51.2885-19/332754362_213006654560252_5358906193870502898_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=7-5","is_verified":true,"is_private":false}]}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 51127053560).","required":true,"schema":{"type":"string","example":"51127053560"}}]}},"/v1/get_post_likers.php":{"get":{"operationId":"get_v1_get_post_likers_php","summary":"getMediaLikers","description":"Retrieve users who liked a specific post, reel, or carousel media.","tags":["Media"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"List of Instagram users who liked a post or reel.","properties":{"status":{"type":"string"},"total_count":{"type":["integer","null"],"description":"Total count of likers for the media post."},"users":{"type":"array","description":"List of user profiles who liked the post.","items":{"type":"object","properties":{"id":{"type":"string"},"pk":{"type":"string"},"username":{"type":"string"}},"required":["id","pk","username"]}}},"required":["status","users"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"status":"success","total_count":2277,"users":[{"id":"46248239623","pk":"46248239623","username":"mr_ashish_9988","full_name":"Ashish Patel","profile_pic_url":"https://instagram.famd5-1.fna.fbcdn.net/v/t51.2885-19/46248239623_n.jpg","is_verified":false,"is_private":true},{"id":"1804291823","pk":"1804291823","username":"priya_sharma","full_name":"Priya Sharma","profile_pic_url":"https://instagram.famd5-2.fna.fbcdn.net/v/t51.2885-19/1804291823_n.jpg","is_verified":true,"is_private":false}]}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"media_code","in":"query","description":"Instagram post or reel media code (e.g. DeJ9vICs5sE).","required":true,"schema":{"type":"string","example":"DeJ9vICs5sE"}}]}},"/v1/get_media_data.php":{"get":{"operationId":"get_v1_get_media_data_php","summary":"getMediaData","description":"Fetch comprehensive post, reel, or carousel media information by shortcode, numeric media ID, or URL.","tags":["Media"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","description":"Comprehensive Instagram media post, reel, or carousel details.","properties":{"id":{"type":"string","description":"Compound media identifier ({pk}_{owner_id})."},"pk":{"type":"string","description":"Numeric media primary key identifier."},"code":{"type":"string","description":"Shortcode of the post or reel."},"caption":{"type":"string","description":"Post caption text."},"like_count":{"type":"integer","description":"Total count of likes."},"comment_count":{"type":"integer","description":"Total count of public comments."},"media_type":{"type":"string","description":"Type of media content (image, video, carousel)."},"display_url":{"type":"string","description":"Highest resolution display image URL."},"video_url":{"type":["string","null"],"description":"Direct playable video URL if video/reel."},"video_duration":{"type":["number","null"],"description":"Duration of video in seconds."},"play_count":{"type":["integer","null"],"description":"Total video play count if video/reel."},"taken_at":{"type":"integer","format":"int64","description":"Creation Unix timestamp.","minimum":-9223372036854776000,"maximum":9223372036854776000},"owner":{"type":"object","description":"Owner of the media post.","properties":{"id":{"type":"string"},"username":{"type":"string"},"full_name":{"type":"string"},"profile_pic_url":{"type":"string"}},"required":["id","username","full_name","profile_pic_url"]},"carousel_media":{"type":["array","null"],"description":"List of child media items if post is an album/carousel.","items":{"type":"object","description":"Individual slide in an Instagram carousel album.","properties":{"id":{"type":"string","description":"Compound ID of the carousel item."},"pk":{"type":"string","description":"Numeric ID of the carousel item."},"media_type":{"type":"string","description":"Item type (image or video)."},"display_url":{"type":"string","description":"Image URL for this slide."},"video_url":{"type":["string","null"],"description":"Video URL if this slide is a video."},"width":{"type":["integer","null"]},"height":{"type":["integer","null"]}},"required":["id","pk","media_type","display_url"]}},"music_info":{"type":"object","description":"Audio/music soundtrack info.","properties":{"artist_name":{"type":["string","null"]},"song_name":{"type":["string","null"]}}},"location":{"type":"object","description":"Location tag attached to the media.","properties":{"id":{"type":["string","null"]},"name":{"type":"string"},"city":{"type":["string","null"]}},"required":["name"]}},"required":["id","pk","code","caption","like_count","comment_count","media_type","display_url","taken_at","owner"]}},"required":["status","data"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"status":"success","data":{"id":"3069135771591354929_9030620359","pk":"3069135771591354929","code":"CqXwrkpJaox","caption":"21 March 2023 ko maine apni Jaan apne bede bete Rishu puttar ko kho diya... #son #donation #bodydonation #pgi","like_count":13916,"comment_count":2687,"media_type":"carousel","display_url":"https://instagram.famd5-1.fna.fbcdn.net/v/t51.82787-15/658436792_18582163405022730_971237627044701434_n.webp","taken_at":1680089516,"owner":{"id":"9030620359","username":"shalini_the_rider","full_name":"Shalini Ranyal","profile_pic_url":"https://instagram.famd5-2.fna.fbcdn.net/v/t51.82787-19/558935782_18314295205300360_7468240570505954399_n.jpg"},"carousel_media":[{"id":"3069135765828286860_9030620359","pk":"3069135765828286860","media_type":"image","display_url":"https://instagram.famd5-1.fna.fbcdn.net/v/t51.82787-15/658436792_18582163405022730_971237627044701434_n.webp","width":1080,"height":1350}]}}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"media_code","in":"query","description":"Instagram post or reel media code (e.g. CqXwrkpJaox).","required":true,"schema":{"type":"string","example":"CqXwrkpJaox"}}]}},"/v1/get_ig_user_followers_v2.php":{"get":{"operationId":"get_v1_get_ig_user_followers_v2_php","summary":"getUserFollowersV2","description":"Recommended paginated endpoint to list followers or following accounts using pagination_token cursor.","tags":["Relationships"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Paginated list of followers or following accounts with pagination_token.","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"pk":{"type":"string"},"username":{"type":"string"}},"required":["id","pk","username"]}},"pagination_token":{"type":["string","null"]}},"required":["users"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"users":[{"id":"71832958416","pk":"71832958416","username":"fresh_veg_nashik","full_name":"Fresh Veg Nashik","profile_pic_url":"https://instagram.famd5-2.fna.fbcdn.net/v/t51.82787-19/842308390_17900153127398417_4356947707626212276_n.jpg","is_verified":false,"is_private":false}],"pagination_token":"9c1fba5706c941d58f34b51bd15618ee"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 9123170068).","required":true,"schema":{"type":"string","example":"9123170068"}},{"name":"pagination_token","in":"query","description":"Pagination token cursor to fetch the next batch.","required":false,"schema":{"type":"string","example":"AQD..."}},{"name":"data","in":"query","description":"Relationship list to retrieve: followers or following.","required":false,"schema":{"type":"string","enum":["followers","following"],"default":"followers"}}]}},"/v1/get_ig_user_followers.php":{"get":{"operationId":"get_v1_get_ig_user_followers_php","summary":"getUserFollowers","description":"Retrieve followers or following accounts for an Instagram profile with legacy start_from pagination and search filtering.","tags":["Relationships"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Paginated list of followers or following accounts with start_from cursor.","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"pk":{"type":"string"},"username":{"type":"string"}},"required":["id","pk","username"]}},"start_from":{"type":["string","null"]}},"required":["users"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"users":[{"id":"71832958416","pk":"71832958416","username":"fresh_veg_nashik","full_name":"Fresh Veg Nashik","profile_pic_url":"https://instagram.famd5-2.fna.fbcdn.net/v/t51.82787-19/842308390_17900153127398417_4356947707626212276_n.jpg","is_verified":false,"is_private":false}],"start_from":"9c1fba5706c941d58f34b51bd15618ee"}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"search_query","in":"query","description":"Optional keyword to filter within the retrieved user list.","required":false,"schema":{"type":"string","example":"fresh"}},{"name":"data","in":"query","description":"Relationship list to retrieve: followers or following.","required":false,"schema":{"type":"string","enum":["followers","following"],"default":"followers"}},{"name":"start_from","in":"query","description":"Legacy pagination cursor to start from.","required":false,"schema":{"type":"string","example":"QVF..."}},{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 9123170068).","required":true,"schema":{"type":"string","example":"9123170068"}}]}},"/v1/get_highlights_stories.php":{"get":{"operationId":"get_v1_get_highlights_stories_php","summary":"getHighlightStories","description":"Retrieve the individual stories and media contained inside a specific highlight.","tags":["Highlights"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"highlight_id":{"type":"string"},"total_count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"pk":{"type":"string"},"code":{"type":"string"},"caption":{"type":"string"},"media_type":{"type":"string","enum":["image","video"]},"display_url":{"type":"string"},"video_url":{"type":"string"},"has_audio":{"type":"boolean"},"taken_at":{"type":"integer","format":"int64","minimum":-9223372036854776000,"maximum":9223372036854776000}},"required":["id","pk","code","caption","media_type","display_url","has_audio","taken_at"]}}},"required":["highlight_id","items"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"highlight_id":"18089261218913911","total_count":2,"items":[{"id":"3321660502580991159_46612673098","pk":"3321660502580991159","code":"C4Y6KDQyRS3","caption":"","media_type":"video","display_url":"https://instagram.fstv8-2.fna.fbcdn.net/v/t51.71878-15/572347890_1376842310674533_5315147040460025594_n.jpg","video_url":"https://instagram.fstv8-3.fna.fbcdn.net/o1/v/t2/f2/m78/AQMZdm5LkHyIKximudBCLRgXu9K4E_7vtMjuRMzN_6rHF-hsDoRkCdpetWVWU_NIGl6OywvsHHFRLR0CKipjstK0vom8fOhAR7DlGsU.mp4","has_audio":true,"taken_at":1710192807},{"id":"3322017173283103479_46612673098","pk":"3322017173283103479","code":"C4aLQSvSWL3","caption":"","media_type":"video","display_url":"https://instagram.fstv8-2.fna.fbcdn.net/v/t51.71878-15/571959615_3209602625861562_9190714814146414174_n.jpg","video_url":"https://instagram.fstv8-1.fna.fbcdn.net/o1/v/t2/f2/m78/AQO21UDh4-ARqR6uSwGOZGt2tlVyAPhmk1bhlMKrNiMpoOV_pV4xOkt8x8Y2rUYbFVesbOV44cam9EwD5ebmEPIzehyjRODPlu3MqpQ.mp4","has_audio":true,"taken_at":1710235325}]}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"highlight_id","in":"query","description":"Highlight numeric ID (e.g. 18089261218913911), prefixed ID (e.g. highlight:18089261218913911), or full Instagram highlight URL.","required":true,"schema":{"type":"string","example":"18089261218913911"}}]}},"/v1/get_ig_user_highlights.php":{"get":{"operationId":"get_v1_get_ig_user_highlights_php","summary":"getUserHighlights","description":"List all highlight reel containers pinned to an Instagram profile.","tags":["Highlights"],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"highlights":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"pk":{"type":"string"},"title":{"type":"string"},"cover_media_url":{"type":"string"},"media_count":{"type":"integer"},"latest_reel_media_int":{"type":"integer"}},"required":["id","pk","title","cover_media_url"]}}},"required":["highlights"]}}},"examples":{"Example_1":{"value":{"success":true,"data":{"highlights":[{"id":"highlight:18089261218913911","pk":"18089261218913911","title":"🫶🏻","cover_media_url":"https://instagram.fstv8-3.fna.fbcdn.net/v/t51.71878-15/628487048_3149664771873200_8128134997751689825_n.jpg","media_count":0,"latest_reel_media_int":0},{"id":"highlight:17989447568622747","pk":"17989447568622747","title":"🎀","cover_media_url":"https://instagram.fstv8-1.fna.fbcdn.net/v/t51.71878-15/656013049_923508503898650_7930152544446440949_n.jpg","media_count":0,"latest_reel_media_int":0}]}}}}}}},"400":{"description":"Bad Request - Missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":400,"type":"MISSING_PARAMETER","message":"Invalid parameter","detail":"Missing required parameter(s): username_or_url"}}}}}}},"401":{"description":"Unauthorized - Invalid or missing credentials","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":401,"type":"UNAUTHORIZED","message":"Unauthorized","detail":"API key required. Provide via 'X-API-Key' or 'Authorization: Bearer <key>' header."}}}}}}},"404":{"description":"Not Found - Resource not found","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":404,"type":"NOT_FOUND","message":"Resource not found","detail":"The requested resource was not found or is unavailable."}}}}}}},"429":{"description":"Too Many Requests - Rate limit or quota exceeded","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":429,"type":"RATE_LIMIT_EXCEEDED","message":"Too Many Requests","detail":"Rate limit of 50 requests per minute exceeded."}}}}}}},"502":{"description":"Bad Gateway - Upstream service error","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":502,"type":"UPSTREAM_ERROR","message":"Upstream service error","detail":"Unable to complete request to Instagram. Please retry shortly."}}}}}}},"503":{"description":"Service Unavailable - Scraper node or service unavailable","content":{"application/json":{"schema":{"type":"object","description":"Standardized API Error Response","required":["success","error"],"properties":{"success":{"type":"boolean"},"error":{"type":"object","required":["code","type","message","detail"],"properties":{"code":{"type":"integer"},"type":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}}},"examples":{"Example_1":{"value":{"success":false,"error":{"code":503,"type":"NODE_UNAVAILABLE","message":"Service Unavailable","detail":"No scraper node currently available to serve requests."}}}}}}}},"parameters":[{"name":"user_id","in":"query","description":"Target Instagram user ID (e.g. 46612673098).","required":true,"schema":{"type":"string","example":"46612673098"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}