← 博客首页

Golddigger API 快速入门：5 分钟接入第一个买家挖掘 Agent

前置要求

• Golddigger 账号（免费注册）
• Python 3.8+
• pip 或 uv 包管理器

第一步：获取 API Key

API Key 格式为 am_us_xxx...，请妥善保管，不要泄露到客户端代码中。

第二步：安装 SDK

pip install golddigger-sdk

或者直接用 requests 库调用 REST API，无需安装 SDK：

pip install requests

第三步：调用第一个搜索接口

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://golddigger.gold"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 示例：搜索澳大利亚矿山营地买家
payload = {
    "query": "mining camp accommodation",
    "country": "AU",
    "industry": "mining",
    "limit": 10
}

response = requests.post(
    f"{BASE_URL}/api/search",
    headers=headers,
    json=payload
)

if response.status_code == 200:
    results = response.json()
    for lead in results.get("leads", []):
        print(f"{lead['company_name']} | {lead['contact_name']} | {lead['email']}")
else:
    print(f"Error {response.status_code}: {response.text}")

第四步：集成到你的 AI Agent

import requests, json

def search_buyers(query, country="US"):
    """根据查询词搜索买家"""
    resp = requests.post(
        "https://golddigger.gold/api/search",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"query": query, "country": country, "limit": 20}
    )
    return resp.json().get("leads", []) if resp.status_code == 200 else []

def agent_response(user_query):
    # 1. 用 DeepSeek 理解用户需求
    # 2. 提取国家、行业、关键词
    # 3. 调用 search_buyers()
    # 4. 用 DeepSeek 总结结果，返回给用户
    leads = search_buyers(user_query, country="AU")
    return f"找到 {len(leads)} 个潜在买家：{json.dumps(leads, indent=2, ensure_ascii=False)}"

常见问题

Q: API 调用频率限制是多少？

FREE 套餐每天 3 次，SUPER 每天 100 次，PREMIUM 不限量。积分消耗约为每条候选人 10-50 积分，视查询复杂度而定。

Q: 支持哪些国家？

Golddigger 数据覆盖全球 180+ 国家，包括美国、英国、澳大利亚、德国、加拿大、中东、东南亚等主要市场。

Q: 数据多久更新一次？

核心数据库每周增量更新，新开市场每月补充。具体行业的更新频率可能不同。

开始免费试用 Golddigger →