文档

60 秒调用 CrustAPI

一个接口，搞定 Google 数据。获取密钥，发送请求，拿回干净的 JSON。通过 MCP 让 AI 助手连接它，或用 x402 让智能体自助付费。全部内容都在本页。

快速开始

在你的控制台免费获取密钥。每月赠送 3,000 点额度，无需绑卡。把密钥放进 x-api-key 请求头，调用一个接口即可。

curl "https://crustapi.com/v1/search?type=web&q=best serp api 2026" \ -H "x-api-key: key_live_xxxx"

返回的数据长这样。一次真实的 type=maps 调用，2026 年 8 月 12 日拉取，截取其中一家商家：

curl "https://crustapi.com/v1/search?type=maps&q=coffee shops in Denver, CO&limit=3" \ -H "x-api-key: key_live_xxxx" { "query": "coffee shops in Denver, CO", "count": 3, "tookMs": 780, "places": [ { "title": "Coffeegraph", "placeId": "ChIJ2eohFQB5bIcRuAe4ToT3TyU", "address": "3800 Julian St, Denver, CO 80211", "categoryName": "Coffee shop", "totalScore": 4.9, "reviewsCount": 412, "location": { "lat": 39.7696963, "lng": -105.0313978 } }, ... 其余 2 家商家 ... ] }

每次成功搜索只扣 1 点额度，无论返回多少条结果。地图是唯一例外，按返回的每家商家计 1 点额度。空结果搜索免费，购买的额度永不过期。每个响应都是同一套稳定的 JSON 结构，且与 serper 保持一致，因此你可以把现有代码直接指向我们，无需改写解析器。

额度价格每 1,000 次
每月 3,000免费，无需绑卡$0
25,000$49$1.96
100,000$149$1.49
500,000$549$1.10
2,500,000$1,999$0.80

额度包最高可达 2.5 亿点，售价 $100,000，即每 1,000 次 $0.40。价格不含税。

Google

一个接口，一个参数即可选择 Google 数据面。改变 type，其余保持不变。

GET https://crustapi.com/v1/search?type=<surface>&q=<query>

你可以请求的数据面：

type返回内容
webGoogle 网页搜索：自然结果、大家还在问、相关搜索
maps本地商家：名称、地址、电话、网站、评分、评论数
places单个地点，采用精简、与 serper 完全一致的结构
newsGoogle 新闻：标题、来源、日期，以及一张真实的主图
shoppingGoogle 购物商品，含价格和卖家
imagesGoogle 图片结果
videosGoogle 视频，含直连缩略图
scholarGoogle 学术论文与引用
patentsGoogle 专利结果
autocomplete针对查询的 Google 自动补全建议
webpage把任意网址转成干净的文本、元数据和 JSON-LD，可直接喂给 AI（RAG）
reviews某商家的 Google 评论，支持排序和分页

常用参数

param作用
q你的搜索查询。大多数数据面必填。
gl国家代码，如 us 或 gb。
hl语言代码，如 en。
location搜索的所在地，用于 maps 和 places，如 Miami, FL。
limit用于 type=maps：返回多少家商家。默认 20，最多 100。
num用于 type=reviews：每页返回多少条评论。最多 50。
page返回第几页结果。

完整的机器可读规范在 /v1/openapi.json。把你的工具或智能体指向它即可。

LinkedIn

通过第二个接口获取公开的、无需登录的 LinkedIn 数据，结构同样干净。用 type 选择你要的内容，传入个人主页或公司网址（或关键词），约一秒即可拿回 JSON。

curl "https://crustapi.com/v1/linkedin?type=profile&url=https://www.linkedin.com/in/williamhgates" \ -H "x-api-key: key_live_xxxx"

你可以请求的类型：

type输入返回内容
profile一个 /in/ 网址完整的公开主页：姓名、标题、简介、所在地、粉丝数、人脉数、工作经历、教育经历和技能
refresh一个 /in/ 网址快速检查主页是否最新：返回姓名、当前公司和学校（含数字 ID），以及是否可访问。专为大规模保持数据库最新而设计。主页无法访问时不计费。
company一个 /company/ 网址公司信息：行业、规模、员工数、总部、网站、专长、相似公司
posts个人主页或公司网址近期动态：正文、点赞数、日期、类型和链接
jobs关键词（可加地点）或职位网址职位搜索结果，或单个职位的完整详情：职位名称、公司、资历级别、描述，以及标示时的薪资
search关键词测试版。查找人物：姓名、标题、当前职位、公司和所在地

参数

param作用
urlLinkedIn 网址，用于 profile、company 和 posts。
keywords搜索内容，用于 jobs 和 search。
location用于 type=jobs 的可选地点筛选。
limit为 posts、jobs 和 search 返回多少条结果。
employees=true用于 type=company：同时返回部分员工样本。
comments=true用于 type=posts：同时返回每条动态的评论数。
enrich=true用于 type=search：为找到的每个人返回完整主页，而不只是摘要。

额度

每次成功调用扣 1 点额度，与 API 其余部分一致。唯一例外是带增强的人物搜索（type=search&enrich=true）：由于每条结果都以完整主页返回，因此按返回的每个主页计 1 点额度，与你直接抓取这些主页的花费完全相同。私密或受限页面返回空结果，且免费。

CLI

更喜欢用终端？安装 CLI，就能在你的 shell 里拿到同样的数据，可选 JSON 或 CSV。

npm install -g crustapi-cli export CRUSTAPI_API_KEY=key_live_xxxx
crust "dentists in miami" crust search coffee --type maps --location "Austin, TX" --limit 20 crust search openai --type news | jq '.news[0]' crust search plumbers --type maps --csv > leads.csv crust scrape https://example.com/pricing --markdown

输出默认是 JSON，可以干净地管道传递，状态行输出到 stderr，因此你的管道不会被污染。加上 --csv 即可输出 CSV。它已发布在 npm 上，名为 crustapi-cli。

面向 AI 助手的 MCP

为 Claude Desktop、Cursor、Cline 或任意 MCP 客户端提供实时 Google 数据。无需安装，npx 会直接运行。把下面这段加入你的客户端配置并重启即可。

{ "mcpServers": { "crustapi": { "command": "npx", "args": ["-y", "crustapi-mcp"], "env": { "CRUSTAPI_API_KEY": "key_live_xxxx" } } } }

会出现三个工具。search 用一次调用覆盖整个菜单，scrape_webpage 把任意网址转成可直接喂给 AI 的干净文本（RAG），get_reviews 拉取某商家的 Google 评论。该包已发布在 npm 上，名为 crustapi-mcp。

集成

CrustAPI 只是一个 HTTP 接口，因此可以接入任何能调用网址的工具。下面是大家问得最多的平台的复制即用配置。

Clay

用实时 Google 数据丰富任意 Clay 表格。添加一个 HTTP API 增强列，并把它指向这里。

# Method GET # URL https://crustapi.com/v1/search?type=maps&q={{Company}}&limit=1 # Headers x-api-key: key_live_xxxx

把某个表格列映射到 {{Company}}（或任意查询），然后把 places[0].website、places[0].phone、places[0].reviewsCount 等字段拉进列中。把 type=maps 换成 web、news 或 reviews，就能用 Google 已知的任何内容做增强。

任意 HTTP 节点（n8n、Make、Zapier、Retool）

到处都是同样的思路：向 /v1/search 发起 GET 请求，把密钥放进 x-api-key 请求头，就能得到可映射到字段的干净 JSON。无需 SDK。

GET https://crustapi.com/v1/search?type=web&q=YOUR%20QUERY Header x-api-key: key_live_xxxx

AI 智能体框架

LangChain、CrewAI、Haystack 和 LlamaIndex 都原生支持加载 MCP 服务器，因此上面的 MCP 配置能让 CrustAPI 成为其中任意一个框架里的工具。原生软件包已经发布：PyPI 上的 langchain-crustapi 和 npm 上的 n8n-nodes-crustapi。其他需求请发邮件到 support@crustapi.com。

智能体支付（x402）

你的智能体无需注册、无需绑卡、无需密钥就能开始。它可以用 x402（开放的 HTTP 支付标准）自行购买额度。如果你的智能体框架已经支持 x402，那么你无需写任何额外代码就能用上。

下面是完整的握手流程。

  1. 你的智能体在不带密钥的情况下调用 POST /v1/x402/topup?pack=agent。
  2. 我们返回 402 Payment Required，附上金额、付款地址，以及 Base 上的 USDC 合约。
  3. 智能体的钱包签署一份免 gas 的 USDC 授权（EIP-3009），并带着签名再次发送请求。
  4. 我们在链上验证并结算，然后返回一个已经充好额度的真实 API 密钥。

从这里开始，这个密钥就和其他密钥一样。智能体调用 /v1/search，花掉它刚买的额度。

402 质询

不带密钥调用充值接口，你就会拿回付款条款。

# ask to top up, no key curl -X POST "https://crustapi.com/v1/x402/topup?pack=agent"
402 Payment Required { "error": "Payment Required", "x402Version": 2, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "asset": "0x8335…2913" } ], "pack": "agent", "priceUsd": 5, "credits": 2500 }

付款之后

你的 x402 客户端签署授权并重试。我们完成结算，返回一个可立即使用的密钥。

200 OK { "apiKey": "key_live_…", "credits": 2500, "packId": "agent", "txHash": "0x…" }

有几点值得了解：

  • 付款使用 Base 上的 USDC，且免 gas。你的智能体签署一份授权，因此无需持有 ETH 来支付 gas。
  • agent 套餐是首充 $5 换 2,500 点额度。更大的套餐运作方式相同，随着用量增长，只需传入不同的 pack。
  • 通过 x402 付款获得的额度与用银行卡购买的额度完全相同。每次成功搜索扣 1 点额度，空结果免费。

询问你的 AI

还有疑问？复制这份包含详细产品说明的 md 文件，拿去问你的智能体。

智能体可以直接在 crustapi.com/llms.txt 获取它。

遇到这里没写到的问题？发邮件到 support@crustapi.com，会有真人回复。