Zum Inhalt springen

// get /v1/author-finder

Autoren-Finder API

Finden Sie die verifizierte E-Mail-Adresse und das vollständige Profil jedes Artikel- oder Blogpost-Autors anhand einer URL.

1 search credit

// api-konsole

GETapi.tomba.io/v1/author-finder
Beispielantwort aus der API-Referenz
email
richard@piedpiper.com
full_name
Richard Hendricks
position
CEO
score
100
verification.status
valid
info.title
Middle-out compression, explained
info.publisher_name
Pied Piper
info.publish_date
2025-03-04

// 01 · anfrage

Author Finder ist eine HTTPS-Anfrage

Senden Sie die Parameter mit Ihrem Schlüssel und Secret. Jedes SDK, die CLI und der MCP-Server stellen genau diesen Aufruf.

GET/author-finderParameter
urlerforderlich
The article URL
curl "https://api.tomba.io/v1/author-finder?url=https%3A%2F%2Fpiedpiper.com%2Fblog%2Fmiddle-out-compression" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · antwort

Was zurückkommt

JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.

GET/author-finderFeld
data.emailstring | null
The address, or null when none is found
data.scoreinteger
Confidence from 0 to 100
data.verification.statusstring | null
valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null
Name, job title and team
data.typestring | null
personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null
Public profiles
data.sources[]array | null
Up to 20 public pages where the address was found, with dates
data.info.title, data.info.publisher_name, data.info.publish_datestring
The article, who published it and when
data.info.candidates[]array | null
Every author candidate on the page, with a name confidence and score
GET /author-finder
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
      }
    ],
    "info": {
      "url": "https://piedpiper.com/blog/middle-out-compression",
      "title": "Middle-out compression, explained",
      "og_image": "https://piedpiper.com/blog/middle-out-compression/cover.png",
      "description": "How middle-out compression reached a Weissman score of 5.2.",
      "article_domain": "piedpiper.com",
      "publisher_name": "Pied Piper",
      "publish_date": "2025-03-04",
      "candidates": [
        {
          "full_name": "Richard Hendricks",
          "first_name": "Richard",
          "last_name": "Hendricks",
          "job_title": "CEO",
          "linkedin": "https://www.linkedin.com/in/richard-hendricks",
          "name_confidence": 0.98,
          "score": 0.95,
          "count": 3
        }
      ]
    }
  }
}

// 03 · kosten und limits

Was ein Aufruf kostet

Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.

// kosten

1search credit

Berechnet, wenn: An address is returned.

Fehler, 429- und 451-Antworten sowie dieselbe Anfrage erneut innerhalb Ihres Nutzungsfensters kosten nichts.

So funktionieren Credits

// rate limits

Anfragen pro Sekunde / Minute / Tag
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. Rate Limits

// faq

Autoren-Finder API-Fragen

Noch Fragen? Zum Hilfezentrum

// schnellstart

Ihr erster Aufruf in einer Minute

Kostenloses Konto, echter API-Schlüssel, dieselben Endpunkte, die Enterprise-Kunden nutzen.

  1. 1Kostenloses Konto erstellen25 Suchen pro Monat. Keine Kreditkarte.
  2. 2Schlüssel und Secret kopierenUnter API-Schlüssel im Dashboard.
  3. 3Die API aufrufenFügen Sie die Anfrage ein; die Antwort ist 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"
Antwort
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": []
  }
}