查询门店信息

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组最小长度 1，最大长度 4
field*	string	过滤字段可选值：{ poi_id, local_store_name, local_store_province, local_store_city, local_store_address, owner_account_id }
operator*	enum	操作符当 field 取值 poi_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 local_store_name 时，枚举列表：{ EQUALS, CONTAINS } 当 field 取值 local_store_province 时，枚举列表：{ EQUALS } 当 field 取值 local_store_city 时，枚举列表：{ EQUALS } 当 field 取值 local_store_address 时，枚举列表：{ EQUALS, CONTAINS } 当 field 取值 owner_account_id 时，枚举列表：{ EQUALS }
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关，详见 [过滤条件] 当 field 取值 poi_id 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 local_store_name 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 local_store_province 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 local_store_city 时，字段长度最小 1 字节，长度最大 120 字节当 field 取值 local_store_address 时，字段长度最小 1 字节，长度最大 120 字节
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10 最小值 1，最大值 2000

返回字段

名称	类型	描述
list	struct[]	返回信息列表
poi_id	string	poi id
local_store_name	string	门店名称
local_store_province	string	门店省
local_store_city	string	门店城市
local_store_address	string	门店地址
local_store_biz_info	struct	门店经营信息
poi_id	string	poi id
customer_profile	struct	门店经营信息用户画像
gender	enum	门店经营信息用户画像性别，[枚举详情]
age	struct[]	年龄（范围为 14~~66，66 代表的是 66 岁及 66 岁以上，如 18~~66 代表大于等于 18 岁）
min	integer	年龄最小值限制，（其中 15、16、17 不可以使用）
max	integer	年龄最大值限制
income	struct[]	门店经营信息用户画像收入
min	integer	收入最小值限制
max	integer	收入最大值限制
vehicle	enum[]	门店经营信息用户画像出行方式，[枚举详情]
customer_per_cost	integer	客单价
first_category_id	integer	一级类目 id,对应门店类目的 vertical_id
second_category_id	integer	二级类目 id
third_category_id	integer	三级类目 id
fourth_category_id	integer	三级类目 id
first_category_name	string	一级类目
second_category_name	string	二级类目
third_category_name	string	三级类目
fourth_category_name	string	四级类目
peak_period	struct[]	门店高峰时间段
time_series	string	门店经营信息客流高峰时间段
date	enum	门店经营信息客流高峰日期，[枚举详情]
opening_hours	struct[]	门店营业时间
time_series	string	门店经营信息营业时间段
date	enum	门店经营信息营业时间日期，[枚举详情]
telephone	string	联系电话，小于 300 个英文字符
special_service	enum[]	特色服务，[枚举详情]
opening_status	enum	门店经营状态，[枚举详情]
intro	string	门店介绍
hide_poi	boolean	是否在广告上隐藏门店信息
wechat_ecosystem_accounts	struct	门店微信生态账户
wxpay_merchant_id	string[]	微信支付商户号,可从查询微信支付商户号接口获取，最多可输入 10 个微信支付商户号
wechat_official_account_id	string	公众号 id
wechat_mini_program_id	string	微信小程序 id
wechat_channels_id	string	视频号 id
created_time	integer	创建时间（时间戳）
last_modified_time	integer	最后修改时间（时间戳）
system_status	enum	门店状态，[枚举详情]
local_store_location	struct	门店位置信息
latitude	float	门店位置纬度
longitude	float	门店位置经度
local_store_category	string	门店分类(腾讯地图)
local_store_type	integer	类型(mp 字段)
local_store_adcode	integer	行政区划代码
local_store_district	string	地区(腾讯地图)
local_store_street	string	街道(腾讯地图)
local_store_business_area	string	商圈(腾讯地图)
local_store_remark	string	备注名称
wechat_work_corp_id	integer	通用 id
wechat_customer_service_link	string	微信客服链接
image_set	struct[]	门店图集，最多上传 8 张
image_id	int64	图片 id，通过 [images 模块] 上传图片后获得
status	enum	门店状态，[枚举详情]
audit_msg	string	审核原因
recommend_words	struct[]	推荐列表，最多 6 行，每行至少 2 个字
recommend_word	string	门店推荐文案，最多 6 行，每行至少 2 个字
status	enum	门店状态，[枚举详情]
audit_msg	string	审核原因
is_use_standardized_name	boolean	是否使用标准化名称
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

curl --location -g --request GET '/v1.3/local_stores/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>&account_id=<ACCOUNT_ID>&filtering=[]&page=1&page_size=10' \ --header 'access_token;' \ --header 'timestamp;' \ --header 'nonce;' \ --header 'fields;' \ --data-urlencode 'account_id=<ACCOUNT_ID>' \ --data-urlencode 'filtering=[]' \ --data-urlencode 'page=1' \ --data-urlencode 'page_size=10'

{ "code": 0, "message": "", "message_cn": "", "data": { "list": [ { "local_store_biz_info": { "customer_profile": { "age": [], "income": [], "vehicle": [] }, "peak_period": [], "opening_hours": [], "special_service": [] }, "wechat_ecosystem_accounts": { "wxpay_merchant_id": [] }, "created_time": 1491019858, "last_modified_time": 1491098468, "local_store_location": [], "image_set": [], "recommend_words": [] } ], "page_info": { "page": 1, "page_size": 10, "total_number": 1, "total_page": 1 } } }

请求参数

Query 参数

access_token

string

必需

示例值:

<ACCESS_TOKEN>

timestamp

string

必需

示例值:

nonce

string

必需

示例值:

<NONCE>

account_id

string

必需

示例值:

<ACCOUNT_ID>

filtering

string

必需

示例值:

[]

page

string

必需

示例值:

page_size

string

必需

示例值:

Header 参数

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

fields

string

必需

指定返回的字段列表，为选填字段，如不填写，则根据默认值进行返回

Body 参数application/x-www-form-urlencoded

account_id

integer

必需

广告主帐号 id，有操作权限的帐号 id，不支持代理商 id

示例值:

<ACCOUNT_ID>

filtering

string

必需

过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件]
数组最小长度 1，最大长度 4

示例值:

[]

page

integer

可选

搜索页码，默认值：1
最小值 1，最大值 99999

示例值:

page_size

integer

可选

一页显示的数据条数，默认值：10
最小值 1，最大值 2000

示例值:

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

list

array [object {7}]

返回信息列表

必需

page_info

object

分页配置信息

必需

请求参数#

返回字段#

请求参数

返回响应

请求参数

返回字段