商家信息库支持地区列表

接口说明

该接口用于获取 Business Listings API 当前支持的地区列表。

请求方式： GET请求地址： https://api.seermartech.cn/v3/business_data/business_listings/locations

你可以通过该接口获取支持的地区单；如需完整地区数据，也可使用平台提供的 CSV 地区文件。

注意：俄罗斯和白俄罗斯的所有地区当前不再受支持。

计费说明

调用本接口不收费。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

可选路径参数

除基础路径外，还可在路径后附加国家代码返回指定国家的地区列表：

/v3/business_data/business_listings/locations/{country}

例如：

/v3/business_data/business_listings/locations/gb

{country} 为国家 ISO 代码。

响应结构

接口返回 JSON 数据，顶层 tasks 数组，每个任务中对应结果。

顶层字段

字段	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表见 /v3/appendix/errors
status_message	string	通用状态信息，完整列表见 /v3/appendix/errors
time	string	执行耗时，单位为秒
cost	float	本次请求总费用，单位为
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务数组

tasks[] 字段

字段	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000；完整列表见 /v3/appendix/errors
status_message	string	任务状态信息
time	string	任务执行耗时，单位为秒
cost	float	当前任务费用，单位为
result_count	integer	result 数组中的数量
path	array	请求路径
data	object	GET 请求 URL 中传的参数
result	array	结果数组

result[] 字段

字段	类型	说明
location_name	string	地区完整名称
country_iso_code	string	地区所属国家的 ISO 代码
business_count	integer	本平台数据库中该地区收录的商家数量

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/business_data/business_listings/locations" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

按国家筛选示例：

curl --location --request GET "https://api.seermartech.cn/v3/business_data/business_listings/locations/gb" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

url = "https://api.seermartech.cn/v3/business_data/business_listings/locations/gb"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json)

TypeScript

import axios from "axios";

// 获取支持地区
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/business_data/business_listings/locations",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
})
 .then((response) => {
 // 输出返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

按国家筛选示例：

import axios from "axios";

// 获取英国支持地区
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/business_data/business_listings/locations/gb",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20221214",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.4116 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "business_data",
 "function": "locations"
 },
 "result": []
 }
 ]
}

状态码说明

你可以通过以下字段判断请求与任务是否成功：

• 顶层 status_code：表示整个请求的通用状态
• tasks[].status_code：表示单个任务的处理状态

常见成功状态：

状态码	说明
20000	请求成功

完整错误码与状态信息请参考 /v3/appendix/errors。

使用建议

• 在发起商家查询前，调用本接口确认可用地区，使用不受支持的地区代码。
• 若你的业务只处理特定国家，建议使用 /locations/{country} 路径缩小结果集。
• 可结合 business_count 字段评估某地区的数据覆盖度，帮助筛选重点市场。

实用场景

• 校验目标地区是否可用：在批量创建商家检索任务前检查地区支持，减少无效请求和任务失败。
• 筛选高覆盖市场：根据 business_count 判断各地区商家收录规模，优选择数据更丰富的城市或区域做本地 SEO 分析。
• 构建地区选择器：将接口返回的 location_name 与 country_iso_code 用于后台或前端的地区下拉菜单，提升任务准确性。
• 限制国家级数据范围：通过 /locations/{country} 获取指定国家支持地区，用于国家站点、本地化投放或区域门店分析。
• 监控地区可用性变化：定期同步支持地区列表，及时发现某些国家或地区是否新增、下线或不再支持。