{"openapi":"3.2.0","info":{"title":"instagram API","description":"ins, instagram ,   instagram api,   search, post and account info and  other enterprise-level APIs  （Contact information： https://discord.gg/3JSAja7Rbr  ，telegram: @yang0619 /   @yue0215  ,    QQ:125569489  , gmail: huojiecs@gmail.com）","version":"1.0.0"},"servers":[{"url":"https://lvqmu.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://lvqmu.jojapi.net/_jojapi/agent/plans","discovery_url":"https://lvqmu.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/instagram-qcugbm","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/base/apitools/ins/account/login":{"get":{"operationId":"get_base_apitools_ins_account_login","summary":"Instagram account login","description":"Login with username+password, returns sessionId and csrfToken for use with authenticated endpoints.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","required":false,"schema":{"type":"string"}},{"name":"password","in":"query","required":false,"schema":{"type":"string"}},{"name":"faCode","in":"query","required":false,"schema":{"type":"string"}},{"name":"fingerprint","in":"query","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/directory/cities":{"get":{"operationId":"get_base_apitools_ins_directory_cities","summary":"Get Instagram cities by country","description":"Get city list by country code with pagination (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"lat","in":"query","description":"纬度","required":false,"schema":{"type":"string","example":"37.7749"}},{"name":"lng","in":"query","description":"经度","required":false,"schema":{"type":"string","example":"-122.4194"}},{"name":"locationPk","in":"query","description":"地点ID（location_pk）","required":false,"schema":{"type":"string","example":"213385402"}},{"name":"q","in":"query","description":"搜索关键词（可选）","required":false,"schema":{"type":"string","example":"coffee"}},{"name":"endCursor","in":"query","description":"分页游标","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"每页返回数量","required":false,"schema":{"type":"string","example":"12"}},{"name":"tab","in":"query","description":"地点帖子 tab：ranked（热门）| recent（最新）","required":false,"schema":{"type":"string","example":"ranked"}},{"name":"countryCode","in":"query","description":"国家代码（cities 端点用）","required":false,"schema":{"type":"string","example":"US"}},{"name":"cityId","in":"query","description":"城市ID（locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"分页页码（cities/locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"maxId","in":"query","description":"分页游标 max_id（section/locations 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/directory/locations":{"get":{"operationId":"get_base_apitools_ins_directory_locations","summary":"Get Instagram locations by city","description":"Get location list by cityId with pagination (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"lat","in":"query","description":"纬度","required":false,"schema":{"type":"string","example":"37.7749"}},{"name":"lng","in":"query","description":"经度","required":false,"schema":{"type":"string","example":"-122.4194"}},{"name":"locationPk","in":"query","description":"地点ID（location_pk）","required":false,"schema":{"type":"string","example":"213385402"}},{"name":"q","in":"query","description":"搜索关键词（可选）","required":false,"schema":{"type":"string","example":"coffee"}},{"name":"endCursor","in":"query","description":"分页游标","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"每页返回数量","required":false,"schema":{"type":"string","example":"12"}},{"name":"tab","in":"query","description":"地点帖子 tab：ranked（热门）| recent（最新）","required":false,"schema":{"type":"string","example":"ranked"}},{"name":"countryCode","in":"query","description":"国家代码（cities 端点用）","required":false,"schema":{"type":"string","example":"US"}},{"name":"cityId","in":"query","description":"城市ID（locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"分页页码（cities/locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"maxId","in":"query","description":"分页游标 max_id（section/locations 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/explore/section":{"get":{"operationId":"get_base_apitools_ins_explore_section","summary":"Get Instagram explore section media","description":"Get media for a specific explore section by sectionId (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/explore/sections":{"get":{"operationId":"get_base_apitools_ins_explore_sections","summary":"Get Instagram explore sections","description":"Get topical explore sections (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/hashtag/info":{"get":{"operationId":"get_base_apitools_ins_hashtag_info","summary":"Get Instagram hashtag info","description":"Get detail info for a hashtag: media_count, profile_pic_url, etc.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/hashtag/recent":{"get":{"operationId":"get_base_apitools_ins_hashtag_recent","summary":"Get Instagram hashtag recent posts","description":"Get most recent posts for a specific Instagram hashtag.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/hashtag/top":{"get":{"operationId":"get_base_apitools_ins_hashtag_top","summary":"Get Instagram hashtag top posts","description":"Get top posts for a specific Instagram hashtag.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/id/media-id":{"get":{"operationId":"get_base_apitools_ins_id_media_id","summary":"Convert Instagram media URL to mediaId","description":"Extract shortcode from URL and convert to numeric mediaId (local computation, no network request).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/id/media-shortcode":{"get":{"operationId":"get_base_apitools_ins_id_media_shortcode","summary":"Convert Instagram mediaId to shortcode","description":"Convert numeric mediaId to shortcode (local computation, no network request).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/id/userId":{"get":{"operationId":"get_base_apitools_ins_id_userId","summary":"Convert Instagram username to userId","description":"Resolve numeric userId from username (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/id/username":{"get":{"operationId":"get_base_apitools_ins_id_username","summary":"Convert Instagram userId to username","description":"Resolve username from numeric userId (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/location/feeds":{"get":{"operationId":"get_base_apitools_ins_location_feeds","summary":"Get Instagram location feeds","description":"Get location posts via GraphQL with tab (ranked/recent) and pagination (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"lat","in":"query","description":"纬度","required":false,"schema":{"type":"string","example":"37.7749"}},{"name":"lng","in":"query","description":"经度","required":false,"schema":{"type":"string","example":"-122.4194"}},{"name":"locationPk","in":"query","description":"地点ID（location_pk）","required":false,"schema":{"type":"string","example":"213385402"}},{"name":"q","in":"query","description":"搜索关键词（可选）","required":false,"schema":{"type":"string","example":"coffee"}},{"name":"endCursor","in":"query","description":"分页游标","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"每页返回数量","required":false,"schema":{"type":"string","example":"12"}},{"name":"tab","in":"query","description":"地点帖子 tab：ranked（热门）| recent（最新）","required":false,"schema":{"type":"string","example":"ranked"}},{"name":"countryCode","in":"query","description":"国家代码（cities 端点用）","required":false,"schema":{"type":"string","example":"US"}},{"name":"cityId","in":"query","description":"城市ID（locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"分页页码（cities/locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"maxId","in":"query","description":"分页游标 max_id（section/locations 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/location/info2":{"get":{"operationId":"get_base_apitools_ins_location_info2","summary":"Get Instagram location info V2","description":"Get location detail via GraphQL (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"lat","in":"query","description":"纬度","required":false,"schema":{"type":"string","example":"37.7749"}},{"name":"lng","in":"query","description":"经度","required":false,"schema":{"type":"string","example":"-122.4194"}},{"name":"locationPk","in":"query","description":"地点ID（location_pk）","required":false,"schema":{"type":"string","example":"213385402"}},{"name":"q","in":"query","description":"搜索关键词（可选）","required":false,"schema":{"type":"string","example":"coffee"}},{"name":"endCursor","in":"query","description":"分页游标","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"每页返回数量","required":false,"schema":{"type":"string","example":"12"}},{"name":"tab","in":"query","description":"地点帖子 tab：ranked（热门）| recent（最新）","required":false,"schema":{"type":"string","example":"ranked"}},{"name":"countryCode","in":"query","description":"国家代码（cities 端点用）","required":false,"schema":{"type":"string","example":"US"}},{"name":"cityId","in":"query","description":"城市ID（locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"分页页码（cities/locations 端点用）","required":false,"schema":{"type":"string","example":"1"}},{"name":"maxId","in":"query","description":"分页游标 max_id（section/locations 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/music/info":{"get":{"operationId":"get_base_apitools_ins_music_info","summary":"Get Instagram music info","description":"Get music/audio info by musicId (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/post/comments":{"get":{"operationId":"get_base_apitools_ins_post_comments","summary":"Get Instagram post comments","description":"Get comments for a specific Instagram post by shortcode, supports pagination.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/post/detail":{"get":{"operationId":"get_base_apitools_ins_post_detail","summary":"Get Instagram post detail","description":"Get detail information for a specific Instagram post by shortcode.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/post/download-link":{"get":{"operationId":"get_base_apitools_ins_post_download_link","summary":"Get Instagram post download link","description":"Extract direct media download links (image/video) from a post by shortcode or URL (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/post/likers":{"get":{"operationId":"get_base_apitools_ins_post_likers","summary":"Get Instagram post likers","description":"Get users who liked a specific Instagram post by shortcode.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/post/topComments":{"get":{"operationId":"get_base_apitools_ins_post_topComments","summary":"Get Instagram post top comments by likes","description":"Get top comments (sorted by likes, popular order) for a specific Instagram post. Pass the numeric mediaId (obtainable from post/detail response). Returns up to count comments sorted by like count descending, covering: comment_id, commenter_username, comment_text, comment_like_count, parent_post_id.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/post/videoUrl":{"get":{"operationId":"get_base_apitools_ins_post_videoUrl","summary":"Get Instagram post/reel video URL","description":"Extract direct video URL from an Instagram post or reel. Pass the full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/) or just the shortcode.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"shortcode","in":"query","description":"Instagram post shortcode (from post URL, e.g. CxYzAbcd123)","required":false,"schema":{"type":"string","example":"CxYzAbcd123"}},{"name":"url","in":"query","description":"Instagram post/reel full URL (e.g. https://www.instagram.com/reel/C4PYiJQubeR/)","required":false,"schema":{"type":"string","example":"https://www.instagram.com/reel/C4PYiJQubeR/"}},{"name":"endCursor","in":"query","description":"Pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"Number of items per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/search":{"get":{"operationId":"get_base_apitools_ins_search","summary":"Search Instagram","description":"Search for users, hashtags, or places on Instagram.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/search/hashtags":{"get":{"operationId":"get_base_apitools_ins_search_hashtags","summary":"Search Instagram hashtags","description":"Search for Instagram hashtags by keyword.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/search/places":{"get":{"operationId":"get_base_apitools_ins_search_places","summary":"Search Instagram places","description":"Search for Instagram locations/places by keyword.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/search/users":{"get":{"operationId":"get_base_apitools_ins_search_users","summary":"Search Instagram users","description":"Search for Instagram users by keyword.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"q","in":"query","description":"search keyword","required":false,"schema":{"type":"string","example":"nature"}},{"name":"type","in":"query","description":"search type: blended | users | hashtags | places","required":false,"schema":{"type":"string","example":"blended"}},{"name":"count","in":"query","description":"max result count","required":false,"schema":{"type":"string","example":"30"}},{"name":"musicId","in":"query","description":"音乐ID（music 端点用）","required":false,"schema":{"type":"string","example":"1234567890"}},{"name":"sectionId","in":"query","description":"探索板块ID（section 端点用）","required":false,"schema":{"type":"string"}},{"name":"maxId","in":"query","description":"分页游标 max_id（music/section 端点用）","required":false,"schema":{"type":"string"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/followers":{"get":{"operationId":"get_base_apitools_ins_user_followers","summary":"Get Instagram user followers","description":"Get followers list for a specific Instagram user by numeric userId, supports pagination. Pass the numeric userId and optional endCursor for pagination.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/following":{"get":{"operationId":"get_base_apitools_ins_user_following","summary":"Get Instagram user following","description":"Get following list for a specific Instagram user by numeric userId, supports pagination. Pass the numeric userId and optional endCursor for pagination.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/info":{"get":{"operationId":"get_base_apitools_ins_user_info","summary":"Get Instagram user info by userId","description":"Get lightweight author snapshot by numeric userId: follower_count, following_count, is_verified, biography. Use this to capture the author snapshot at crawl time alongside post data.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/posts":{"get":{"operationId":"get_base_apitools_ins_user_posts","summary":"Get Instagram user posts","description":"Get posts for a specific Instagram user, supports pagination.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/posts2":{"get":{"operationId":"get_base_apitools_ins_user_posts2","summary":"Get Instagram user posts V2","description":"Get user posts via GraphQL with end_cursor pagination (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/profile":{"get":{"operationId":"get_base_apitools_ins_user_profile","summary":"Get Instagram user profile","description":"Get profile information for a specific Instagram user.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/profile2":{"get":{"operationId":"get_base_apitools_ins_user_profile2","summary":"Get Instagram user profile V2","description":"Get flat-format user profile (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/reels":{"get":{"operationId":"get_base_apitools_ins_user_reels","summary":"Get Instagram user reels","description":"Get reels for a specific Instagram user, supports pagination.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/related-profiles":{"get":{"operationId":"get_base_apitools_ins_user_related_profiles","summary":"Get Instagram related profiles","description":"Get related/suggested profiles for a user (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/reposts":{"get":{"operationId":"get_base_apitools_ins_user_reposts","summary":"Get Instagram user reposts","description":"Get reposted media by a user (login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/tagged":{"get":{"operationId":"get_base_apitools_ins_user_tagged","summary":"Get Instagram user tagged posts","description":"Get posts where the user has been tagged, supports pagination.","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}},"/base/apitools/ins/user/web-profile":{"get":{"operationId":"get_base_apitools_ins_user_web_profile","summary":"Get Instagram web profile","description":"Get web profile info by username (anonymous access, no login required).","responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}},"parameters":[{"name":"username","in":"query","description":"Instagram username (used for profile lookup)","required":false,"schema":{"type":"string","example":"cristiano"}},{"name":"userId","in":"query","description":"Instagram numeric user ID (required for posts/reels/tagged endpoints)","required":false,"schema":{"type":"string","example":"173560420"}},{"name":"endCursor","in":"query","description":"pagination cursor (end_cursor from previous response)","required":false,"schema":{"type":"string"}},{"name":"count","in":"query","description":"result count per page","required":false,"schema":{"type":"string","example":"12"}},{"name":"resFormat","in":"query","required":false,"schema":{"type":"string","example":"json"}},{"name":"proxyUrl","in":"query","required":false,"schema":{"type":"string"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}