Unlocker API
一次调用即可突破任何防护，返回任意页面，格式为 Markdown 或结构化 JSON。反爬虫处理、代理轮换、CAPTCHA 破解和 JavaScript 渲染全部在请求内部完成。
- Cloudflare、Akamai、DataDome、PerimeterX 及所有主流 CAPTCHA，均在调用内部处理
- 受保护目标上 99.6% 成功率
- 代理为你托管：轮换和封禁重试；档位由你选择
- 支持等待和页面操作的 JavaScript 渲染
- HTML、Markdown、截图或 JSON 输出，字段自动解析
- 使用你自己的模型密钥进行 AI 解析
使用 Google 注册支持 MCP一条命令即可连接你的智能体：
npx -y @datafuel/mcp initwww.amazon.com
United States/s?k=wireless+headphones
1Request
2Retrieve
3Format
4Ready
www.amazon.com
Opening the source page
One request starts the example.
一个请求搞定一切
一览式概要，详细介绍见下文。绕过反爬虫与 WAFCloudflare、Akamai、DataDome、PerimeterX、Imperva。每个请求自动处理指纹和 TLS。
CAPTCHA 破解reCAPTCHA、hCaptcha、Turnstile、DataDome 滑块：在调用内部完成破解，无需第三方打码服务。
轮换与封禁重试被封锁的 IP 会被替换，请求在到达你的代码之前就已重试。
Basic / Premium 档位按请求选择代理档位：大多数页面用 Basic，最难的用 Premium。
地理定位proxy_country 可将请求路由到 195+ 个国家；Premium 支持州/省和城市。
粘性会话proxy_session_id 可在多个请求之间保持同一 IP，适用于登录和购物车。
JavaScript 渲染真实浏览器，在提取前执行 wait_for_selector 和 js_instructions（点击、填写、等待）。
请求头、Cookie、设备每次调用都可自定义请求头、Cookie、User-Agent 和设备类型。
七种输出格式一个 result_format 即可输出 HTML、Markdown、文本、JSON、截图、PDF 或结构化字段。
AI 解析，使用你的密钥一条提示词加一个 JSON schema，即可将任意页面转为字段；token 费用按你的服务商密钥计费。
异步批量任务POST /job 提交数百个 URL，多线程处理，立即返回 ID，一次调用获取全部结果。
按成功付费，数据分析失败的请求免费；控制台中可按密钥和接口查看用量。
DatafuelUnlocker API · AI parsing
Processing
JSON ready
AI providerOpenAI
AnthropicGemini
OpenAIAnthropicGemini›Extract name, price, currency, rating and availability as JSON
Opening the shopping result
Extracting the requested fields
Sending to your model
shopping.google.com · product result
Loading
HTTP 200
nameAir Jordan 1 Retro High OG, Size 43price · currency€189.99rating★★★★★4.8 (6,120)in_stockIn stocksneakershop.example · free delivery · demo data
Sent to OpenAI on your keyai_provider: openai
Your JSON is ready
{
"name": "Air Jordan 1 Retro High OG, Size 43",
"price": 189.99,
"currency": "EUR",
"rating": 4.8,
"in_stock": true
}
Datafuel opens the result page through a premium residential exit.
The fields named in your prompt are located on the page.
Prompt and page go to your provider, on your key. The model shapes the answer.
The same values, as the JSON you asked for.
01 · AI 解析
使用你自己的 API 密钥进行 AI 解析
随请求发送一条提示词和一个 JSON schema。页面通过我们的网络获取后，交给使用你密钥的你的模型：OpenAI、Anthropic 或 Google。你得到的是字段而不是 HTML，模型 token 由你的服务商计费，而不是我们。
curl https://scraping-api.datafuel.ai/api/v1/task \-H "X-API-Key: $DATAFUEL_API_KEY" \-H "Content-Type: application/json" \-d @- <<EOF{"type": "unlocker","proxy_type": "Basic","proxy_country": "US","attributes": {"url": "https://example.com/product/123","method": "GET","result_format": "json","result_use_ai": true,"result_ai_prompt": "Extract product name, price and stock status","result_ai_format": {"title": "string","price": "number","in_stock": "boolean"},"ai_provider": "openai","ai_model": "gpt-4o-mini","ai_api_key": "$OPENAI_API_KEY"}}EOF
DatafuelUnlocker API · anti-bot & CAPTCHA
Processing
200 OK
urltripadvisor.com/Hotel_Review-demoproxy_typePremiumresult_formatmarkdown
Demo data · illustrative scenario. The five challenge types are shown in sequence; a real request meets whichever one the target serves.Challenge 1 of 5 · Cloudflare Turnstile
Challenge 2 of 5 · Cloudflare Challenge
Challenge 3 of 5 · AWS WAF
Challenge 4 of 5 · reCAPTCHA
Challenge 5 of 5 · Microsoft
tripadvisor.com/Hotel_Review-demo
Challenge page
Verify you are human
Success!
challenge page · solving inside the request
cleared · the original request continues
Checking your browser before accessing the site…
Verification passed
challenge page · solving inside the request
cleared · the original request continues
Verifying that you are not a robot…
Verification complete
challenge page · solving inside the request
cleared · the original request continues
I’m not a robot
Verified
challenge page · solving inside the request
cleared · the original request continues
Prove you’re human
Verified
challenge page · solving inside the request
cleared · the original request continues
Cloudflare TurnstileCloudflare ChallengeAWS WAFreCAPTCHAMicrosoft
Listing delivered · 200 OK
{
"status": "completed",
"status_code": 200,
"final_url": "https://tripadvisor.com/Hotel_Review-demo",
"blocked": false,
"credits_used": 10,
"duration_ms": 4210,
"result": { "data": "# Grand Harbour Hotel\n4.5 · 2,318 reviews…" }
}
Cloudflare Turnstile is solved inside the request, with a TLS fingerprint that is new on every call. Your code never sees the widget.
Cloudflare’s managed challenge (the “checking your browser” page) passes the same way, on a rotating IP.
AWS WAF challenge pages are verified and the original request continues.
reCAPTCHA, every version: solved automatically. No third-party solver to wire up.
Microsoft’s human check, cleared. The proxy tier is yours to set; pin one IP with proxy_session_id.
200 OK, one call billed. This request met Turnstile; the same call clears the other four. Failed attempts are free.
02 · 防护
反爬虫与代理管理
Cloudflare、Akamai、DataDome、PerimeterX 以及所有主流 CAPTCHA 都在请求内部处理：每次调用使用全新的 TLS 指纹，被封即轮换；对最难的目标设置 proxy_type: Premium 即可使用 Premium 出口。当登录或购物车需要时，proxy_session_id 可在多次调用中固定同一 IP。
curl https://scraping-api.datafuel.ai/api/v1/task \-H "X-API-Key: $DATAFUEL_API_KEY" \-H "Content-Type: application/json" \-d '{"type": "unlocker","proxy_type": "Premium","proxy_country": "GB","attributes": {"url": "https://example.com/account/orders","method": "GET","proxy_session_id": "checkout-8f3a","result_format": "json"}}'
DatafuelUnlocker API · bulk jobs
Processing
Results ready
POST/api/v1/joburls512 URLs · amazon · walmart · tripadvisor · google …multithreadedtrue · concurrency 75proxy_typeBasic
Endpoints and fields follow the public OpenAPI spec; the pace is not measured latency.POST /job · 512 URLs accepted, id returned at once
Polling GET /job/{id} · 75 tasks in flight
Completed · 512 of 512 tasks
job9f2c7a1e-4b3d-4e7a-9c21-demo
created
processing
completed
tasks_count
512
512
512
512
512
512
tasks_done
0
96
211
318
437
512
running
0/ 75
75/ 75
75/ 75
75/ 75
75/ 75
0/ 75
credits_used
0
96
211
318
437
512
progress512 tasks
concurrency75 of 100 allowed
queued
processing
done · 1 credit
queued
processing
done · 1 credit
queued
processing
done · 1 credit
queued
processing
done · 1 credit
queued
processing
done · 1 credit
queued
processing
done · 1 credit
… 506 more tasks
GET /job/{id}/results
{
"tasks_count": 512,
"tasks_complete": 512,
"tasks_failed": 0,
"credits_used": 512,
"tasks_result": [
{ "id": "c41e…", "result": "# Wireless Noise-Cancelling Headphones…" },
{ "id": "7b09…", "result": "# Pokémon 151 Elite Trainer Box · $89.97…" },
{ "id": "e2d5…", "result": "# Grand Harbour Hotel · 4.5 · 2,318 reviews…" },
… 509 more
]
}
One POST with 512 URLs across many sites. The API answers with a job id before anything is scraped.
Poll GET /job/{id}. With multithreaded: true, 75 tasks run at once, under your plan's limit of 100; counters move as each one finishes.
status: completed. 512 tasks, nothing left to wait for.
GET /job/{id}/results returns one entry per URL. Credits are charged per completed task; failed tasks are not.
03 · 批量任务
批量任务，异步执行
在一个 POST /job 中提交跨多个网站的数百个 URL。ID 立即返回，任务按套餐并发上限并行运行，GET /job/{id}/results 为每个 URL 返回一条结果。Idempotency-Key 让重试安全无忧；失败的任务不计费。
API=https://scraping-api.datafuel.ai/api/v1# 1. queue the batch → {"id": "9f2c7a1e-…"}curl "$API/job" \-H "X-API-Key: $DATAFUEL_API_KEY" \-H "Idempotency-Key: batch-2026-09-13-a" \-H "Content-Type: application/json" \-d '{"type": "unlocker","multithreaded": true,"proxy_type": "Basic","attributes": {"urls": ["https://amazon.com/dp/B0DEMO123","https://walmart.com/ip/demo-456","https://tripadvisor.com/Hotel_Review-demo"],"result_format": "markdown"}}'# 2. poll progress → {"status": "processing",# "tasks_count": 3, "tasks_done": 1, ...}curl "$API/job/$JOB_ID" \-H "X-API-Key: $DATAFUEL_API_KEY"# 3. fetch every result once status is "completed"curl "$API/job/$JOB_ID/results" \-H "X-API-Key: $DATAFUEL_API_KEY"
DatafuelUnlocker API · JavaScript rendering
Processing
Rendered
urlwalmart.com/browse/toys/pokemon-cards-demojs_renderingtruewait_for_selector[data-price]js_instructions[{ "click": "#load-more" }]
Loading the page shell
JavaScript ran: prices are in
Action: click “Load more”
walmart.com/browse/toys/pokemon-cards-demo
JavaScript pending
Rendered
Pokémon TCG: Scarlet & Violet Booster Bundle
price loading…
$26.88
Pokémon 151 Elite Trainer Box
price loading…
$89.97
Charizard ex Premium Collection
price loading…
$49.88
Paldean Fates Premium Collection
price loading…
$49.99
Load more
Charizard ex Premium Collection$49.88
Paldean Fates Premium Collection$49.99
Rendered result · one request
{
"status": "completed",
"status_code": 200,
"final_url": "https://walmart.com/browse/toys/pokemon-cards-demo",
"credits_used": 5,
"duration_ms": 6840,
"result": { "data": "# Pokémon cards\nScarlet & Violet Booster Bundle · $26.88 …" }
}
A real browser loads the page. Images, fonts and media are never fetched.
The page's JavaScript runs; Datafuel waits until the prices exist before going on.
Your action runs before extraction, and the list grows in place.
The rendered content comes back as one request.
04 · 渲染
JavaScript 渲染
js_rendering: true 会在真实浏览器中加载页面，等待你指定的选择器，执行你的页面操作（点击、填写、等待），然后再提取内容。用 block_resource 屏蔽图片、字体和媒体以保持快速；渲染页面费用为 5 个积分而非 1 个。
curl https://scraping-api.datafuel.ai/api/v1/task \-H "X-API-Key: $DATAFUEL_API_KEY" \-H "Content-Type: application/json" \-d '{"type": "unlocker","proxy_type": "Basic","proxy_country": "US","attributes": {"url": "https://app.example.com/product","method": "GET","js_rendering": true,"wait_for_selector": "#price","result_format": "json"}}'
价格
只为成功请求付费
选择月度套餐、一次性购买积分，或使用不限线程套餐。失败的请求永不计费。
每个套餐都包含所有端点和所有接口（API、MCP）。共用一个积分余额：你只为用量付费，而且只为成功的请求付费。
每月需要多少次请求？每月 1,000,000 基础页面
≈ 1,000,000 积分 · Growth1K300K1M3.5M12M定制
Growth最适合
适合需要充裕容量的生产级爬虫和智能体。
原价 $79，现价 $55.30 $79/ 月，按月计费
1,000,000 积分 / 月1,000,000 基础页面25 并发线程$0.055$0.079 每 1K 基础页面$0.277$0.395 每 1K JS 页面
- 包含 Starter 的全部功能
- 自动充值
- 优先聊天支持
Business
适合按计划交付数据产品的团队。
原价 $199，现价 $139.30 $199/ 月，按月计费
3,500,000 积分 / 月3,500,000 基础页面50 并发线程$0.040$0.057 每 1K 基础页面$0.199$0.284 每 1K JS 页面
- 包含 Growth 的全部功能
- 按 API 密钥设置用量提醒
- 客户经理
Scale
大用量，最低单页价格。即时开通。
原价 $499，现价 $349.30 $499/ 月，按月计费
12,000,000 积分 / 月12,000,000 基础页面150 并发线程$0.029$0.042 每 1K 基础页面$0.146$0.208 每 1K JS 页面
- 包含 Business 的全部功能
- 专属 IP 池
- 99.9% SLA
对比
| Free | Starter | Growth | Business | Scale | Enterprise | |
|---|---|---|---|---|---|---|
| 每月积分 | 1K 一次性 | 300K | 1M | 3.5M | 12M | 定制 |
| 并发线程 | 2 | 10 | 25 | 50 | 150 | 250+ |
| API 密钥 | 1 | 3 | 10 | 25 | 无限制 | 无限制 |
| JS 渲染 | ||||||
| 住宅代理 | ||||||
| AI 实时提取（使用你的密钥） | ||||||
| 地理定位 · 195+ 个国家 | ||||||
| 批量多 URL | ||||||
| Unlocker · Crawl · Map · LLM Scraper | ||||||
| 自动充值 | — | — | ||||
| 支持 | 社区 | 邮件 | 优先聊天 | 客户经理 | Slack + 电话 | 专属支持 + SLA |
一次请求实际花费多少？1 积分 = 1 个基础页面 · 费用不叠加：JS + 住宅代理为 20 积分，而不是 5 + 10
1×基础 HTTP简单 HTML，数据中心代理
5×JS 渲染用于动态网站的无头浏览器
10×住宅代理真实住宅 IP
20×JS + 住宅代理全力应对受保护网站
免费AI In-Flight任意 Unlocker 请求均可使用 LLM 提取（使用你自己的 AI 密钥），不额外消耗积分
FAQ
常见问题
真正的疑虑，直截了当地回答。
请求与输出你发送什么，返回什么。
什么算作一次成功请求？
包含你所请求内容的响应：来自目标且带有正文的 2xx 响应；或在使用 AI 提取时，符合你 result_ai_format 的 JSON 对象。封锁、我们未能通过的 CAPTCHA、超时和空响应均视为失败，不收取任何费用。
支持哪些输出格式？
通过 result_format 支持 json、csv、txt、markdown、png、jpeg 和 pdf。Markdown 是 LLM 流水线的常用选择；设置 result_use_ai 并提供提示词和 JSON 结构，即可获得结构化字段。
什么时候需要 js_rendering？
只有当页面在浏览器中生成内容时才需要：无限滚动、客户端渲染的价格、单页应用。先尝试不开启，普通请求便宜 5 倍且更快。wait_for_selector 用于告诉浏览器内容何时就绪。
需要自己的 AI 密钥吗？
是的，目前需要。在 Datafuel 自有模型就绪之前，AI 提取使用你自己的服务商和合同：传入 ai_provider（openai、anthropic 或 google）、ai_model 和 ai_api_key，模型将在你的账户上运行。
防护与计费封锁、上限以及你的费用。
支持哪些防护系统？
Cloudflare、Akamai、DataDome、PerimeterX（HUMAN）及主流 CAPTCHA 类型，以及通用反爬虫系统和限流器。这些都在请求内部处理，无需针对每种防护设置参数。
目标网站封锁我时会发生什么？
Unlocker 会自动换用新 IP 和新指纹重试。如果仍无法获得可用响应，请求即为失败，消耗 0 积分。按域名的分析会显示每个目标的成功率和成本，让你清楚看到问题出在哪里。
有速率限制或并发上限吗？
并发按账户计算：GET /users/@me 会显示 current_concurrency 和 concurrency_limit，你可以在控制台中提高上限，或与我们联系。大批量任务请使用 POST /job，它会将 URL 排队并返回一个 ID，你可用它轮询进度和结果。
可以在多个请求之间保持同一 IP 吗？
可以。传入 proxy_session_id，带有该 ID 的每个请求都会从同一 IP 发出，这正是登录、浏览页面、结账等多步骤流程所需要的。