DataForSEO 技能

按需付费的 Google 搜索结果页（SERP）+ SEO 数据 API。最适合低成本、高并发的线索生成场景。无需月度订阅 —— 仅为您实际使用的部分付费。

认证凭据

DATAFORSEO_LOGIN=your_email@example.com
DATAFORSEO_PASSWORD=your_password

请在 dataforseo.com 注册账户。最低充值金额：$50。每次 SERP 任务费用约为 $0.0006（批量调用时成本极低）。

快速上手 —— SERP 搜索

import requests, os, json
from base64 import b64encode

def dfs_auth():
    creds = f"{os.environ['DATAFORSEO_LOGIN']}:{os.environ['DATAFORSEO_PASSWORD']}"
    return b64encode(creds.encode()).decode()

def dfs_search(keyword: str, location: str = "United States", language: str = "en") -> list[dict]:
    """
    通过 DataForSEO Live SERP 接口执行 Google 搜索。
    返回自然搜索结果：{url, title, description, rank_absolute, domain}
    """
    headers = {
        "Authorization": f"Basic {dfs_auth()}",
        "Content-Type": "application/json"
    }
    payload = [{
        "keyword": keyword,
        "location_name": location,
        "language_name": language,
        "device": "desktop",
        "os": "windows",
        "depth": 10
    }]
    
    url = "https://api.dataforseo.com/v3/serp/google/organic/live/advanced"
    r = requests.post(url, headers=headers, json=payload)
    r.raise_for_status()
    
    data = r.json()
    tasks = data.get("tasks", [])
    if not tasks or tasks[0]["status_code"] != 20000:
        return []
    
    items = tasks[0]["result"][0].get("items", [])
    organic = [i for i in items if i.get("type") == "organic"]
    
    return [{
        "title": i.get("title"),
        "url": i.get("url"),
        "description": i.get("description"),
        "rank": i.get("rank_absolute"),
        "domain": i.get("domain")
    } for i in organic]

线索生成 —— 批量模式（最高效）

def dfs_batch_search(queries: list[str], location: str = "United States") -> dict[str, list]:
    """
    单次 API 调用提交多个查询（最多支持 100 个）。
    效率显著提升 —— 多个查询仅需一次网络往返。
    返回字典格式：{query: [results]}
    """
    headers = {
        "Authorization": f"Basic {dfs_auth()}",
        "Content-Type": "application/json"
    }
    
    # 构建任务列表
    tasks = [{
        "keyword": q,
        "location_name": location,
        "language_name": "en",
        "device": "desktop",
        "depth": 10,
        "tag": q  # 使用查询词作为 tag，便于结果匹配
    } for q in queries]
    
    # 提交任务
    url = "https://api.dataforseo.com/v3/serp/google/organic/task_post"
    r = requests.post(url, headers=headers, json=tasks)
    task_ids = [t["id"] for t in r.json()["tasks"] if t["status_code"] == 20100]
    
    # 轮询获取结果（任务通常在 ~10–60 秒内完成）
    import time
    time.sleep(15)
    
    results = {}
    for task_id in task_ids:
        result_url = f"https://api.dataforseo.com/v3/serp/google/organic/task_get/advanced/{task_id}"
        res = requests.get(result_url, headers=headers)
        items = res.json()["tasks"][0]["result"][0].get("items", [])
        organic = [i for i in items if i.get("type") == "organic"]
        tag = res.json()["tasks"][0].get("tag", task_id)
        results[tag] = [{"title": i["title"], "url": i["url"], "domain": i.get("domain")} for i in organic]
    
    return results

可用 API 接口端点

Maps 搜索（本地线索生成首选）

def dfs_maps_search(query: str, location_code: int = 1023191) -> list[dict]:
    """
    在 Google Maps 中搜索本地商家。
    返回字段：{title, url, phone, address, rating, reviews_count}
    location_code 1023191 = Portland, OR。位置代码可在以下接口查询：
    https://api.dataforseo.com/v3/serp/google/locations
    """
    headers = {"Authorization": f"Basic {dfs_auth()}", "Content-Type": "application/json"}
    payload = [{
        "keyword": query,
        "location_code": location_code,
        "language_code": "en",
        "device": "desktop"
    }]
    url = "https://api.dataforseo.com/v3/serp/google/maps/live/advanced"
    r = requests.post(url, headers=headers, json=payload)
    items = r.json()["tasks"][0]["result"][0].get("items", [])
    return [{
        "title": i.get("title"),
        "url": i.get("url"),
        "phone": i.get("phone"),
        "address": i.get("address"),
        "rating": i.get("rating", {}).get("value"),
        "reviews": i.get("rating", {}).get("votes_count"),
        "category": i.get("category")
    } for i in items if i.get("type") == "maps_search"]

位置代码（常见美国城市）

LOCATION_CODES = {
    "Portland, OR": 1023191,
    "Seattle, WA": 1027744,
    "Dallas, TX": 1026339,
    "Chicago, IL": 1016367,
    "Los Angeles, CA": 1013962,
    "New York, NY": 1023191,
    "Denver, CO": 1016143,
    "Phoenix, AZ": 1023725,
    "Atlanta, GA": 1013971,
    "Miami, FL": 1017862,
}
# 完整列表：GET https://api.dataforseo.com/v3/serp/google/locations

价格参考

以每日 50 次查询的线索生成场景为例：每日成本约 $0.03–$0.08。

DataForSEO 与 Serper 的适用场景对比