有段时间没更新API分享文章了，主要最近在更新功能没时间写，刚好由于产品功能需求，又接触到一个有趣的API，就分享一下。
这个API叫“门店到访客群画像分布”，主要用于线下实体门店到访客群的画像统计和分析的，比较契合我们的产品功能需求，整体接入过程还是比较顺利，数据也满足要求，如果有感兴趣的开发者和创业者也可以去体验一下！
API相关参数说明
先看看API的标准开发文档，几个关键参数便能体现其数据特性和价值：
Query 请求参数
|
名称 |
类型 |
是否必需 |
字段含义 |
示例值 |
|---|---|---|---|---|
|
month |
string |
可选 |
到访月份 |
2025-01 |
|
aoi_id |
string |
可选 |
场景ID |
7698721 |
|
analysis_type |
string |
可选 |
1：基础画像，2：收入消费，3：业态偏好，4：交通方式， 5：餐饮偏好， 6：商场偏好， 7：品牌偏好， 8：手机终端， 9：业态偏好（粗），11：手机运营商 |
1 |
|
research_type |
string |
可选 |
1：职驻地，2：商场...... |
1 |
|
business |
string |
可选 |
analysis_type=6|7时，需要提供 |
居家日用 |
|
category |
string |
可选 |
analysis_type=9时生效，不传或者传空，默认查一级业态占比。一级业态枚举：餐饮，零售，生活配套，休闲娱乐，家庭亲子 |
餐饮 |
从Query参数可知，这个客流API可以获取指定月份、指定场景（门店）的到访客群画像，涵盖基础画像（如年龄、性别）和各种偏好画像（如消费、兴趣），对实体门店的客群统计和分析的价值还是很大的。
返回响应字段说明
|
名称 |
类型 |
是否必需 |
字段含义 |
|---|---|---|---|
|
response_id |
string |
是 |
平台公共网响应ID |
|
code |
integer |
是 |
公共网关响应码 |
|
message |
string |
是 |
公共网关响应码 |
|
biz_code |
integer |
是 |
API服务响应码 |
|
biz_message |
string |
是 |
API服务响应码 |
|
data |
object |
是 |
性别、婚姻、有无小孩、有无房产、孩子年龄、学历、年龄段、职业分布 |
返回响应：如果Query参数选择的是1基础画像，那么就会得到性别、婚姻情况、生育情况等八大基础画像数据，维度还是比较丰富的；Query参数选择不同，得到的数据也不同，就不一一展开，想了解具体返回数据的建议去平台体验。
API获取及接入指南
一、注册与在线获取
1、在及刻开放平台首页右上角注册后，进行到控制台，查看已经订购的API和创建API Keys，，用于后续接口调用；
2、在平台能力中心页面找到“泛客流”栏目，找到“门店到访客群画像分布”API；
3、进入API详情页便能获取API，平台的【在线体验】页面是提供部分API 的
在线测试
，这个功能非常好，不需要花钱便能体验部分API的效果，省去很多测试成本。
二、接口调用示例
API提供多种编程语言的SDK，以下以Python为例，展示区域人群画像接口的示例代码：
import http.client
conn = http.client.HTTPSConnection("data-api.isjike.com")
payload = ''
headers = {}
conn.request("GET", "/api/v1/citymap/BasePersona?month=2025-01&aoi_id=4818184&analysis_type=1&research_type=1&business=%E5%B1%85%E5%AE%B6%E6%97%A5%E7%94%A8&category=%E9%A4%90%E9%A5%AE", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
复制
|
返回的参数示例： |
|---|
|
{"code":200,"message":"成功","data":{"date":"2025-01","data":{"性别":{"man":0.5183440955206012,"woman":0.48165590447939877},"婚姻":{"已婚":0.7406,"未婚":0.25939},"有无小孩":{"有":0.66654,"无":0.33346},"有无房产":{"有":0.9009398496240602,"无":0.09906015037593985},"孩子年龄":{"0-3岁（婴幼儿）":0.40609,"4-6岁（学龄前）":0.21827,"7-12岁（小学生）":0.29949,"13-17岁(初高中生)":0.07614},"学历":{"高学历（大学、大专、研究生）":0.4624,"中学历（高中）":0.40601,"低学历（初中及以下）":0.13157},"年龄段":{"18-24岁":0.09398,"25-29岁":0.13909,"30-34岁":0.27067,"35-39岁":0.14661,"40-44岁":0.1203,"45-49岁":0.12406,"50-54岁":0.04511,"55-59岁":0.03383,"60-64岁":0.01128,"65-69岁":0.01504,"70-74岁":0,"75-79岁":0,"80-84岁":0,"85岁以上":0},"职业分布":{"餐饮行业工作人员":0.05185,"医院工作人员":0.01481,"汽车保养行业工作人员":0.00741,"金融工作人员":0.00741,"政府工作人员":0.08148,"景区工作人员":0.03704,"购物行业工作人员":0.04444,"娱乐行业工作人员":0.01481,"丽人行业工作人员":0.00741,"写字楼白领":0.22222,"教育行业工作人员":0.05926,"铁路工作人员":0.00741,"外卖员":0.01481,"工厂蓝领工":0.07407,"自由职业者":0.35555}}},"error":"","billing":{"count":1,"price":0}} |
API调试过程中发现API的响应速度还是很快的，而且返回的数据正是企业所需要的数据，接入到产品中，就能得到实体门店客群的画像分析功能，还是可以的。
总的来说，这个门店到访客群画像分布API还是很有趣的，价值也有的，对于一些干零售、餐饮等行业的创业者或开发者，能够提供不少数据支撑，可以去接入玩玩！
来自 “ ITPUB博客 ” ，链接：https://blog.itpub.net/70046922/viewspace-3093870/ ，如需转载，请注明出处，否则将追究法律责任。
请登录后发表评论
登录
全部评论
