全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
根据关注时间段批量查询微信粉丝用户信息
接口地址： http://api.vv-tool.com/tool/erps/wsc-info-search
接口介绍： 根据 fansId 正序批量查询微信粉丝用户信息（不受关注时间限制），仅支持商家自己公众号下的粉丝查新
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺 id |
| end_follow | java.lang.String | 是 | 关注的结束时间。查询在该时间之前关注的粉丝，不能为空，查询时间间隔不能超过一天，格式同 start_follow |
| only_follow | java.lang.Short | 否 | 是否仅拉取关注的粉丝。1:仅拉取已关注的粉丝 0:拉取已关注和已跑路粉丝 0:拉取已关注和已跑路粉丝，1:仅拉取已关注的粉丝 |
| page_no | java.lang.Integer | 否 | 页码，page_no * page_size 参数不超过 10000。若备选数据多于 10000 条，请通过调整 start_follow/end_follow 来缩小时间范围。 |
| fields | java.lang.String | 否 | 需要返回的除微信粉丝基础信息外的资产信息。枚举值：points，trade，level。points 可获取“points”字段，trade 可获取”traded_num,trade_money”两个字段，level 可获取”level_info”字段信息。传多个枚举值需用“,”分隔，如果该字段为空则只返回粉丝基础信息。默认为空。(“fields”字段传入枚举值越多，查询数据耗费时间越长。） |
| start_follow | java.lang.String | 是 | 关注的起始时间。查询在该时间之后（包含该时间）关注的粉丝，不能为空。格式可为“20170101”或“2017-01-01 12:00:00' |
| page_size | java.lang.Integer | 否 | 每页条数，最大值：50。默认为 10。 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | int | 返回状态码 | |
| msg | string | 返回码描述 | |
| msec | int | 接口执行时间 | |
| time | int | 接口返回时间 | |
| data | object | 数据信息 | |
| --users | java.util.List | 用户信息列表 | |
| --level_info | object | 否 | 粉丝会员等级的数据结构 |
| ----level_id | java.lang.Long | 否 | 会员等级 id |
| ----level_name | java.lang.String | 否 | 会员等级名 |
| --country | java.lang.String | 否 | 国家 |
| --nick | java.lang.String | 否 | 微信粉丝用户的昵称 |
| --province | java.lang.String | 否 | 省份 |
| --is_follow | java.lang.Boolean | 否 | 是否关注公众号 |
| --user_id | java.lang.Long | 否 | 微信粉丝用户 ID |
| --traded_num | java.lang.Integer | 否 | 成交订单笔数（当入参 fields 字段传入'trade'枚举值才会返回该字段。） |
| --trade_money | java.lang.Integer | 否 | 成交订单总额。单位：元。（当入参 fields 字段传入'trade'枚举值才会返回该字段。） |
| --weixin_open_id | java.lang.String | 否 | 微信粉丝用户的 openid，可用于微信 API |
| --follow_time | java.lang.String | 否 | 关注时间，时间戳，单位：秒 |
| --avatar | java.lang.String | 否 | 微信粉丝用户的头像 Url |
| --city | java.lang.String | 否 | 所在城市 |
| --points | java.lang.Long | 否 | 当前积分（当入参 fields 字段传入'points'枚举值才会返回该字段。） |
| --sex | java.lang.String | 否 | 性别。可选值：m(男)，f(女)。未知则为空 |
| --total_results | java.lang.Long | 3987 | 搜索到的微信粉丝用户总数 |
| --withholding_money | int | 该接口扣费金额（点券） |
返回数据
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |