按用户名或 ID 获取 Instagram 用户资料
查看 Instagram 公开资料与内容数据 API 的全部接口 →按用户名或数字用户 ID 解析公开 Instagram 账号。传入 username_or_id——例如用户名 instagram 或 ID 25025320,两种形式解析到同一条记录。实测响应把资料包在 data 里:id、username、full_name、biography、follower_count、following_count、media_count、is_verified、is_private、profile_pic_url 与 profile_pic_url_hd,账号公开时还会有 external_url、bio_links 与账号类目字段。设 include_about=true 可在账号公开时追加含 country 与 date_joined 的 about 对象。未命中时返回 HTTP 200 且正文恰好是 {"detail":"Not found"}——把它当作业务级未命中,而不是一份资料。
API 功能
用户名或 ID 输入 传公开用户名(instagram)或数字用户 ID(25025320),两者解析为同一份资料。
完整公开资料字段 返回简介、粉丝数、关注数、帖子数、认证与私密标记、外链与头像地址。
可选 about 块 include_about=true 时,在账号公开的前提下追加国家与注册时间字段。
明确的未命中结果 用户名不存在时返回 HTTP 200 且 detail 为 Not found,无需解析异常即可低成本识别未命中。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/instagram/user-info API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/instagram/user-info?key=<API_KEY>&username_or_id=instagram'
curl -X GET 'https://api.opendata-api.com/api/project/instagram/user-info?key=<API_KEY>&username_or_id=instagram'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 红人初筛:入围前为候选账号补充账号 ID、简介、粉丝数与认证状态。
- 留存带时间戳的 follower_count 快照,对比多次采集间的粉丝增长。
- 把用户名一次性解析为稳定的数字用户 ID,供其余接口复用。
- 以 detail 为 Not found 的业务结果作为账号流程的闸门,而不是对不存在的资料反复重试。
常见问题
如何通过 Instagram 用户名查询数字用户 ID?
把用户名传入 username_or_id,响应 data 中的 id 即为数字用户 ID;之后可用该 ID 调用本接口及其余接口,两种形式解析结果一致。
接口返回 HTTP 200 但 detail 是 Not found 应该怎样处理?
这是业务级未命中:目标用户名不存在或不可见。不要把响应当成资料入库,也不要立刻重试;记录未命中并核对用户名拼写即可。
Instagram 私密账号有哪些资料可见,哪些内容不能获取?
私密账号返回 is_private=true 及基本资料字段(简介、各项计数、头像),但其帖子、快拍与粉丝/关注内容不会开放。