Google Maps API

Google Maps 联系方式 API

在 Google Maps 上搜索商家，并为每条结果补全联系方式（来自其网站的邮箱、电话和社交主页），每次请求最多 20 条记录。

POST/v1/run/maps.contacts
可用率
98.92%
30d · 556 次调用
请求数
556
30d · 按周，近 12 周
响应时间
56.0s
中位数 · 30d

服务商网络

按流量排序的服务商

试一试

发出你的第一个请求

requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `city` 或 `postalCode`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个商家确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "address": "123 Main St",
        "categories": [
          "example"
        ],
        "category": "general",
        "cid": "a1b2c3d4",
        "city": "San Francisco",
        "countryCode": "US",
        "domain": "example.com",
        "emails": [
          "alex@example.com"
        ],
        "facebooks": [
          "example"
        ],
        "image": "https://example.com/image.jpg",
        "instagrams": [
          "example"
        ],
        "language": "en",
        "latitude": 37.7749,
        "linkedIns": [
          "https://example.com/page"
        ],
        "longitude": -122.4194,
        "name": "Example title",
        "neighborhood": "example",
        "phone": "+1 555-0142",
        "phones": [
          "+1 555-0142"
        ],
        "placeId": "a1b2c3d4",
        "postalCode": "94107",
        "rank": 1,
        "rating": 4.6,
        "reviewCount": 12500,
        "state": "CA",
        "street": "123 Main St",
        "tiktoks": [
          "example"
        ],
        "twitters": [
          "example"
        ],
        "url": "https://example.com/page",
        "website": "https://example.com/page",
        "youtubes": [
          "example"
        ]
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface MapsContactsResponse {
  data: {
    items: {
      address?: string;
      categories?: string[];
      category?: string;
      cid?: string;
      city?: string;
      countryCode?: string;
      domain?: string;
      emails?: string[];
      facebooks?: string[];
      image?: string;
      instagrams?: string[];
      language?: string;
      latitude?: number;
      linkedIns?: string[];
      longitude?: number;
      name: string;
      neighborhood?: string;
      phone?: string;
      phones?: string[];
      placeId: string;
      postalCode?: string;
      rank?: number;
      rating?: number;
      reviewCount?: number;
      state?: string;
      street?: string;
      tiktoks?: string[];
      twitters?: string[];
      url: string;
      website?: string;
      youtubes?: string[];
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/maps.contacts
curl -X POST https://api.getanyapi.com/v1/run/maps.contacts \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"location":"Austin, TX","placeMinimumStars":"four","query":"coffee shop","website":"withWebsite"}'
字段类型示例值
请求体
locationstring"Austin, TX"要搜索的地点，自由文本，最好是城市加国家（例如 Denver, USA）。
querystring"coffee shop"你会在 Google Maps 搜索栏中输入的内容（例如 dentist）。
categoryFilterWordsarray可选，要保留的 Google Maps 地点类别名称列表；结果仅限类别与其中之一匹配的地点。请使用 Google Maps 上显示的小写类别名称（例如 ["dentist", "orthodontist"]）。省略则包含所有类别。
languagestring结果使用的两字母语言代码（例如 en）。
limitinteger3最多返回的结果数（1-20，默认 20）。
placeMinimumStarsenum"four"仅返回平均评分不低于该值的地点：two（2+）、twoAndHalf（2.5+）、three（3+）、threeAndHalf（3.5+）、four（4+）或 fourAndHalf（4.5+）。没有评价的地点会被排除。省略则不按评分筛选。
requireFieldsarray可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `city` 或 `postalCode`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个商家确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
websiteenum"withWebsite"按地点是否列出网站筛选：allPlaces（默认）、withWebsite（仅有网站的地点）或 withoutWebsite（仅没有网站的地点）。联系方式补全会从地点的网站提取邮箱和社交主页，因此 withWebsite 针对的是可以补全的潜在客户。
响应
dataobjectThe result wrapper, or null when nothing matched.
data.itemsobject[]Matching business records, each enriched with contact details scraped from the business website. Populated whenever the provider has data for the entity.
data.items[].addressstringFull formatted street address.
data.items[].categoriesstring[]Every Google Maps category listed for the business.
data.items[].categorystringPrimary business category.
data.items[].cidstringGoogle customer/place id (cid).
data.items[].city可设为必填stringCity the business is in.
data.items[].countryCode可设为必填stringTwo-letter country code.
data.items[].domainstringRegistrable domain of the business website.
data.items[].emailsstring[]Email addresses scraped from the business website.
data.items[].facebooksstring[]Facebook profile URLs found on the business website.
data.items[].imagestringPrimary business photo URL.
data.items[].instagramsstring[]Instagram profile URLs found on the business website.
data.items[].language可设为必填stringTwo-letter language code of the listing Google served.
data.items[].latitudenumberLatitude of the business in decimal degrees.
data.items[].linkedInsstring[]LinkedIn profile URLs found on the business website.
data.items[].longitudenumberLongitude of the business in decimal degrees.
data.items[].namestringBusiness name. Populated whenever the provider has data for the entity.
data.items[].neighborhood可设为必填stringNeighborhood the business is in.
data.items[].phonestringBusiness phone number in E.164 format, when listed on Google Maps.
data.items[].phonesstring[]Additional phone numbers scraped from the business website.
data.items[].placeIdstringGoogle Maps place id (stable identifier for the business). Populated whenever the provider has data for the entity.
data.items[].postalCode可设为必填stringPostal code of the business.
data.items[].rankintegerOne-based position of the business in the Google Maps result order.
data.items[].ratingnumberAverage star rating out of 5.
data.items[].reviewCountnumberTotal number of reviews.
data.items[].state可设为必填stringState or region the business is in.
data.items[].street可设为必填stringStreet portion of the address.
data.items[].tiktoksstring[]TikTok profile URLs found on the business website.
data.items[].twittersstring[]X/Twitter profile URLs found on the business website.
data.items[].urlstringCanonical Google Maps URL for the business. Populated whenever the provider has data for the entity.
data.items[].websitestringThe business website URL, when listed.
data.items[].youtubesstring[]YouTube channel URLs found on the business website.
foundbooleanTrue when the search returned at least one matching business.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
价格
每次请求价格USDUS$0.00325
价格（/千次请求）USDUS$3.25

常见问题

关于 Google Maps 联系方式 API

AnyAPI 的 Google Maps 联系方式 API 只需一次 POST 请求 /v1/run/maps.contacts，就以统一格式的 JSON 返回 Google Maps 数据。在 Google Maps 上搜索商家，并为每条结果补全联系方式（来自其网站的邮箱、电话和社交主页），每次请求最多 20 条记录。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$3.25 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Google Maps 联系方式 API 调用中有 98.9% 成功，响应时间中位数为 56.0 秒，共测量 556 次调用。

费用：每千次请求 US$3.25 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

在 Google Maps 上搜索商家，并为每条结果补全联系方式（来自其网站的邮箱、电话和社交主页），每次请求最多 20 条记录。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Google Maps 联系方式 API 调用中有 98.9% 成功，响应时间中位数为 56.0 秒，共测量 556 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。
更多接口

Google Maps 的其他接口

地点/千次请求 US$1.75 起评价/千次请求 US$3.50 起搜索/千次请求 US$1.75 起搜索附近地点/千次请求 US$1.30 起