跳到主要内容

// get /v1/similar

相似域名 API

通过我们的 RESTful API,基于任何网站域名查找相似公司和竞争对手域名。

1 per 10 search credits

// api 控制台

GETapi.tomba.io/v1/similar
API 参考中的示例响应
[0].website_url
hooli.com
[0].name
Hooli
[0].industries
internet

// 01 · 请求

Similar Domains只需一个 HTTPS 请求

使用您的密钥和密钥密码发送参数。每个 SDK、CLI 和 MCP 服务器都发出相同的调用。

GET/similar参数
domainpiedpiper.com
Company domain (or send company)
limit10
Results per page
curl "https://api.tomba.io/v1/similar?domain=piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · 响应

返回的内容

JSON,在任何语言中都相同。Tomba 不知道的字段为 null,绝不猜测。

GET/similar字段
data[].website_urlstring
Each similar company's domain
data[].name, data[].industriesstring | null
Its name and industry
meta.total, meta.total_pagesinteger
Similar companies found, and pages
meta.current, meta.pageSizeinteger
This page and its size
meta.paramsobject
The parameters the search ran with
GET /similar
200 OK· 1 per 10 search credits
{
  "data": [
    {
      "website_url": "hooli.com",
      "name": "Hooli",
      "industries": "internet"
    },
    {
      "website_url": "endframe.com",
      "name": "Endframe",
      "industries": "computer software"
    }
  ],
  "meta": {
    "total": 2,
    "pageSize": 10,
    "current": 1,
    "total_pages": 1,
    "params": {
      "domain": "piedpiper.com",
      "page": 1,
      "limit": 10
    }
  }
}

// 03 · 费用和限制

调用的费用

仅在满足以下条件时才对调用收费。速率限制取决于您的套餐。

// 费用

1 per 10search credit

收费条件: Results are returned. 1 credit per 10 results requested with limit.

错误、429 和 451 响应,以及在用量窗口内重复的相同请求均不收费。

积分如何运作

// 速率限制

每秒 / 每分钟 / 每天请求数
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 100 / 4,000

Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. 速率限制

// 常见问题

相似域名 API 问题

还有其他问题? 访问帮助中心

// 快速入门

一分钟内完成首次调用

免费账户、真实的 API 密钥,与 Enterprise 客户使用相同的端点。

  1. 1创建免费账户每月 25 次搜索。无需信用卡。
  2. 2复制您的密钥和密钥密码在控制台的 API 密钥页面获取。
  3. 3调用 API粘贴请求;返回结果为 JSON。
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
响应
200 OK· 1 search credit
{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "sources": [
      {
        "uri": "https://piedpiper.com/blog/engineering",
        "website_url": "piedpiper.com",
        "extracted_on": "2024-06-01T09:14:07+01:00",
        "last_seen_on": "2025-01-10T17:02:44+01:00",
        "still_on_page": true
      }
    ],
    "phone_data": []
  }
}