客流类API实测：门店到访客群画像数据获取

原创

API测评玩玩咯

修改于 2025-08-21 11:43:58

3030

有段时间没更新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参数选择不同，得到的数据也不同，就不一一展开。

一、在线获取

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}}

返回的参数示例：

{"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的响应速度还是很快的，而且返回的数据正是企业所需要的数据，接入到产品中，就能得到实体门店客群的画像分析功能，还是可以的。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

大数据