常住省市查询

查询棋盘用户资产和人群的常住城市画像分析。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/merchant/qipan/insightcity/query' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "crowd_id":"89532803202831xxxx", "relation_type":"user_vis", "report_date":"20230102" }'

{ "portrait_key":"PROVINCE_CITY_DITU", "portrait_name":"预测常住城市", "portrait_desc":"用户省市分布预测", "coverage":"0.9544224", "report_date":"20230102", "data_list":[ { "portrait_value":"浙江省", "num":3000, "area_code":"330000", "city_list":[ { "portrait_value":"杭州市", "area_code":"330100", "num":123 } ] } ] }

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

crowd_id

string

可选

人群id，按人群分析时必传

relation_type

string

可选

用户关系类型，不传人群id时必传枚举值访问: user_vis 收藏小程序: user_col 订阅消息: user_subs 关注生活号: user_follow 入商家群: user_group 入会: user_mem 支付: user_pay 导入: user_import

report_date

string

可选

数据日期，格式yyyyMMdd，非必填。由于数据每天可能有变化，可以指定数据对应的日期，指定后可以查询日期对应的数据计算结果，不填默认返回前一天的数据。注意事项最大传昨天的日期，比如今天是2023年1月11日，则传不大于2023110的值，否则会报错参数异常。

示例

返回响应

🟢200成功

application/json

Body

portrait_key

string

必需

常住城市画像类型，固定值PROVINCE_CITY_DITU

portrait_name

string

必需

常住城市的画像名称，固定返回“预测常住城市”，和B站画像名称相同

portrait_desc

string

必需

常住省市画像描述，固定返回“用户省市分布预测”

coverage

string

必需

画像值中去除未知和其他后的总量占当前画像总量的比例注意事项固定浮点数数据，但是以String形式传输

report_date

string

数据产出的日期

必需

data_list

array [object {4}]

省级数据列表

必需

portrait_value

string

可选

num

integer

可选

area_code

string

可选

city_list

array [object {3}]

可选