最近自研产品需要接入一个门店客流统计的能力，需要输入目标场景ID就能立即获取相关客流数据。
刚好了解到一个门店客流趋势API，便能解决门店客流数据获取问题，有着标准的开发文档，调用起来也蛮方便，总体感觉还行，感兴趣的可以去体验一下。
API相关参数说明介绍这个API的获取方式前，我们先看看API的参数说明，了解其关键参数都有什么：
Query参数名称
类型
是否必需
字段含义
start_month
string
是
起始月份（示例值：2025-05）
end_month
string
是
终止月份（示例值：2025-06）
poi_id
string
是
场景ID（示例值：2525825）
从Query参数可知，你只需要提供确定场景的ID，加上想要查询的时间周期（起始和终止），便能获取相关场景的客流趋势数据，需要提供的内容不多，还是较简单的。
返回响应字段说明名称
类型
是否必需
字段含义
response_id
string
是
平台公共网响应ID
code
integer
是
公共网关响应码
message
string
是
公共网关响应参数
biz_code
integer
是
API服务响应码
biz_message
string
是
API服务响应信息
res
array
可选
天级客流
avg
object
可选
日均客流
cnt
object
可选
总客流
res_waimai
array
可选
外卖天级客流
avg_waimai
object
可选
外卖日均人数
cnt_waimai
object
可选
外卖总人数
competitor
object
可选
竞品ID
cost
string
可选
月总收入
out_uv
integer
可选
累计过店客流
可选择返回的门店客流数据种类很多，有按天的客流，也有平均客流，甚至还会提供外卖客流，这对于门店统计客流数据来说蛮重要的。
除了自身客流数据，还能获取竞品相关的客流趋势，可以做简单的竞品门店客流分析。
返回的这些数据对于做门店客流统计和分析的人来说，其效率提升应该会很大，也能省去很多的人力和时间成本，总体来说API还是值得体验的。
API体验及接入指南注册与在线体验1、在平台能力中心页面找到“泛客流”栏目，找到门店客流趋势API，点击查看详情；
2、进入API详情页后，右上角是API的标准开发文档，在正式调用前可以去先研究一下文档；
3、平台的【在线体验】页面是提供部分API 的在线体验，这个功能很实用，省去很多测试成本。
回到分享的核心API：“门店客流趋势API”，接口设计简洁易用，开发者可以快速集成到系统中，以下是关键步骤：
1.注册与登录平台控制台，获取门店客流趋势API Key，用于后续接口调用；
2.接口调用示例
提供多种编程语言的SDK，以下以Python为例，展示门店客流趋势API接口的调用方法：
代码语言：javascript复制import http.client
conn = http.client.HTTPSConnection("data-api.isjike.com")
payload = ''
headers = {}
conn.request("GET", "/api/v1/citymap/HistoryCustomer?start_month=%202025-04&end_month=%202025-04&poi_id=%202515824", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
实际测评下来，接口的响应还是很快的，返回的数据也比较准确，满足门店客流统计与分析的需求，如果有类似需求的开发者可以去体验体验。