Zum Inhalt springen

// massenverarbeitung

Massen-Autorensuche

Laden Sie eine CSV-Datei mit Artikel-URLs hoch und finden Sie alle E-Mail-Adressen der Autoren auf einmal.

Article URLsBis zu 5,000 Zeilen pro JobCSV, Liste oder Zeilen
author-finder-list.csv2,500 Zeilen · article urlscompleted
Massen-Author Finder · /bulk/author2,500 / 2,500
  1. 01pendingPOST /v1/bulk/author201 · { "data": { "id": 1042 } }
  2. 02runninglaunch: trueFortschritt abgefragt mit GET /v1/bulk/author/1042/progress
  3. 03completedbulk.completedsignierter Webhook an Ihre webhook_url zugestellt
GET /v1/bulk/author/1042/download?file=fullBerechnet beim ersten Download · der Job läuft nach 180 Tagen ab

// 01 · eingabe

Die Eingabe eines Author Finder-Massen-Jobs

Laden Sie in der App eine CSV-Datei mit bis zu 4 MB hoch oder senden Sie eine Liste, Zeilen oder eine Datei an POST /v1/bulk/author. Spalten werden anhand der Kopfzeile erkannt; legen Sie einen Feldindex fest, um selbst eine auszuwählen.

POST/bulk/authorSpalten
url_field_index
Article URL
POST/bulk/authorOptionen
include_sources
true adds the web pages where each address was found

// 02 · api

Eine Anfrage startet den Job

Erstellen und starten Sie ihn mit einem Aufruf, verfolgen Sie dann den Fortschritt oder empfangen Sie ein signiertes bulk.completed-Ereignis. Jede Ergebniszeile entspricht dem, was GET /author-finder zurückgibt.

curl -X POST "https://api.tomba.io/v1/bulk/author" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Author Finder job","list":"https://piedpiper.com/blog/middle-out-compression","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'
POST /bulk/author
201 Created
{
  "data": {
    "id": 1042
  }
}
Jede Zeile, wie GET /author-finder sie zurückgibt
200 OK
{
  "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 Job kostet

Für das Erstellen oder Starten eines Jobs wird nichts berechnet. Seine Kosten werden einmalig beim ersten Download der Ergebnisse abgerechnet.

// abrechnung pro zeile

1 search credit per article with an author address.

Abrechnung von Massen-Jobs in der Dokumentation
  • Zeilen: bis zu 5,000 pro Job
  • Jobs created: 15 per day for each type
  • Running jobs: 2 per type
  • Downloads: 25 per day for each job
  • Request size: 4 MB (CSV, list or rows)

// kunden

Teams, die Author Finder-Jobs ausführen

  • Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
    Nicholas RizzoSenior Digital Manager, Vizme
  • Tomba has been critical to my SEO and cold outreach workflow. None matched Tomba's accuracy or the depth of contact details it returns.
    Henry HoeSEO & Sales Outreach Specialist

// faq

Häufig gestellte 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": []
  }
}