接口说明
- 请求需带上参数token,每个用户有唯一的token。
- 所有接口均返回json格式,其中参数message表示是否请求成功.
- 当返回message!="请求成功"时,可以参考返回的message字段
- 一般来说,接口只要返回cost=true,就表示请求有效,会进行收费,此时请不要再重试了,这种情况一般是请求资源已经失效(404)。
- Instagram接口请求延时较长,建议timeout设置为30秒,否则可能会出现请求超时但实际请求成功导致账号扣费的场景。
测试token
token: 请联系管理员开通 q:1098441010 vx:pchell11
余额查询
http://43.134.116.51:10002/instagram/get_user_balance/?token=test
返回如下:
{
"cost": false,
"data": {
"count": 100
},
"message": "请求成功"
}
获取用户详情
http://43.134.116.51:10002/instagram/user_info/?token=test&username=leomessi
username为用户个人主页链接名字
返回如下:
{
"cost": true,
"data": {
"data": {
"user": {
... # 其他字段
"id": "427553890" # user_id
}
},
"status": "ok"
},
"message": "请求成功"
}
用户帖子列表
http://43.134.116.51:10002/instagram/user_feed/?token=test&username=leomessi&user_id=427553890&cursor=
username 为用户个人主页链接名字
user_id 可以从user_info接口中获取
每页返回10条。
如果要翻页,需要传入cursor参数(当前请求结果里返回的next_max_id,可用于翻页),第一次请求不需要传此参数。
返回如下:
{
"cost": true,
"data": {
"auto_load_more_enabled": false,
"items":[
...,
{
...,
"pk":"3128106731628187825", # feed_id
"code":"CtWxxX8tIo1" # code_url
},
]
"more_available": true,
"next_max_id": "3109889503539931700_427553890", # 翻页参数
"num_results": 10,
"status": "ok",
"user":{...}
},
"message": "请求成功"
}
评论
http://43.134.116.51:10002/instagram/comment/?token=test&code_url=CtWxxX8tIo1&feed_id=3122902288875948597&cursor=
code_url跟feed_id均可以从用户帖子接口中获取
每页返回15条。
如果要翻页,需要传入cursor参数(当前请求结果里返回的next_min_id,可用于翻页),第一次请求不需要传此参数。
返回如下:
{
"cost": true,
"data": {
...
"comments": [
...,
{
...
"pk":"17880043532880328" # comment_id
}
],,
"next_min_id": "{\"cached_comments_cursor\": \"17983477136029656\", \"bifilter_token\": \"KGQBEADQADAAIAAYABgAEAAIAAgAt_3__-_39-__t_v3_v___7Zf1fqu3f-37-f9hVuB8jWl2VA8RabT0fv---_b__9___37v___87p9_e_-3L_v__97__--5_Gll_iLQaGOUQBgAA==\"}", # 翻页参数
},
"message": "请求成功"
}
回复
http://43.134.116.51:10002/instagram/reply/?token=test&code_url=CtWxxX8tIo1&feed_id=3122902288875948597&comment_id=18051698953430558&cursor=
comment_id 可以从评论接口中获取
每页返回15条。
如果要翻页,需要传入cursor参数(当前请求结果里返回的 next_max_child_cursor,可用于翻页),第一次请求不需要传此参数。
返回如下:
{
"cost": true,
"data": {
"child_comment_count": 49,
"child_comments": [...],
"next_max_child_cursor": "QVFCWm9fczIyd1g3NFFLT0RsMUI0ZWQxcUpwU0U3V3NLQnVORmZKOHNYZjNpTDk5d3JGVE9NVHZtOU5SY0plUk84S3RhbDd6ekpnTzBiaXZEUWR1SWNsdg==", # 翻页参数
"status": "ok"
},
"message": "请求成功"
}
搜索
http://43.134.116.51:10002/instagram/search/?token=test&keyword=美女&cursor=
cursor :翻页参数,上一页的next_max_id
keyword: 搜索关键词
返回如下:
{
"cost": true,
"data": {
...
},
"message": "请求成功"
}
搜索用户
http://43.134.116.51:10002/instagram/search_user/?token=&keyword=&cursor=
keyword: 搜索关键词
返回如下:
{
"cost": true,
"data": {
...
},
"message": "请求成功"
}
根据贴文id获取贴文详情
http://43.134.116.51:10002/instagram/get_detail_by_id/?token=test&feed_id=3417054023375926630&code_url=C95kQIJSc8m
code_url跟feed_id均可以从贴文列表接口中获取
返回如下:
{
"cost": true,
"data": {
...
},
"message": "请求成功"
}
根据url获取贴文详情
http://43.134.116.51:10002/instagram/get_detail_by_url/?token=test&url=https://www.instagram.com/p/C-l2YR_N70O
返回如下:
{
"cost": true,
"data": {
...
},
"message": "请求成功"
}
注意:由于网络运营商的拦截策略,请求中包含ins域名可能会被拦截,可以使用http://43.134.116.51:10002/instagram/get_detail_by_url/?token=test&url=p/C-l2YR_N70O请求
tag贴文列表
http://43.134.116.51:10002/instagram/tag_feed_list/?token=test&tag_name=nba&cursor=''
cursor :翻页参数,上一页的next_max_id
tag_name注意不用包含#
返回如下:
{
"cost": true,
"data": {
...
},
"message": "请求成功"
}
常见错误示例
[
{
"data": {},
"message": "请求超时,请重试",
"cost": False
},
{
"data": {},
"message": "token验证失败",
"cost": False
},
{
"data": {},
"message": "余额不足",
"cost": False
},
{
"data": {},
"message": "帖子不存在",
"cost": True
},
{
"data": {},
"message": "tag不存在",
"cost": True
},
{
"data": {},
"message": "用户不存在",
"cost": True
},
{
"data": {},
"message": "用户帖子列表不存在",
"cost": True
},
{
"data": {},
"message": "评论不存在",
"cost": True
},
{
"data": {},
"message": "评论不显示",
"cost": True
},
{
"data": {},
"message": "** 不能为空",
"cost": False
}
]