Comment fonctionne l'API Bulk Author Finder ?

Créez une opération groupée en téléchargeant les URL des articles, puis lancez l'opération. L'API extrait les informations sur les auteurs et trouve leurs adresses e-mail de manière asynchrone pour toutes les URL.

Quelle est la taille maximale du lot ?

Vous pouvez traiter jusqu'à 10 000 URL d'articles par opération groupée. Pour les ensembles de données plus volumineux, créez plusieurs opérations groupées.

Quels types d'URL sont pris en charge ?

L'API fonctionne avec les articles de blog, les articles de presse et les pages de contenu de la plupart des plateformes CMS, notamment WordPress, Medium, Ghost et les systèmes de publication personnalisés.

Quels résultats sont renvoyés ?

Chaque résultat comprend l'adresse e-mail de l'auteur, son nom complet, son entreprise, son poste, son profil LinkedIn, son score de confiance et les sources où les informations ont été trouvées.

Combien de temps prend le traitement ?

Le temps de traitement dépend du nombre d'URL. Le traitement typique dure 2 à 3 secondes par URL. Un lot de 5 000 URL est généralement terminé en quelques heures.

Comment sont calculés les crédits ?

Chaque URL qui renvoie un e-mail d'auteur compte pour 1 requête. Les URL pour lesquelles aucun e-mail d'auteur n'est trouvé ne sont pas prises en compte dans votre quota.

Les webhooks sont-ils pris en charge ?

Oui, configurez une URL de webhook pour recevoir une notification lorsque votre opération de recherche d'auteurs groupée se termine avec des résultats prêts à être téléchargés.

Que se passe-t-il si un article a plusieurs auteurs ?

L'API renvoie l'adresse e-mail de l'auteur principal. Pour les articles comportant plusieurs auteurs, envisagez d'utiliser des appels API Author Finder individuels.

Puis-je l'utiliser pour les relations publiques numériques et la sensibilisation des journalistes ?

Oui. Les équipes utilisent Bulk Author Finder pour créer des listes de médias et de contributeurs à grande échelle, puis acheminer les contacts de haute confiance vers des séquences de sensibilisation.

Qu’est-ce qui contribue à améliorer la précision des correspondances ?

Fournissez des URL d'articles canoniques propres, évitez les pages de page d'accueil/de catégorie et supprimez les doublons d'URL avant la soumission pour maximiser la qualité de l'extraction.

// post /v1/bulk/author

API de recherche d'auteurs en masse

Transformez des milliers d’URL d’articles en enregistrements de contacts d’auteurs vérifiés avec une seule demande groupée asynchrone.

Obtenir une clé API gratuite Référence de l'API

Article URLsJusqu'à 5,000 lignes

POST /bulk/author

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"}'

const res = await fetch("https://api.tomba.io/v1/bulk/author", {
  method: "POST",
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "Author Finder job",
    "list": "https://piedpiper.com/blog/middle-out-compression",
    "launch": true,
    "webhook_url": "https://hooks.example.com/tomba"
  })
});
const { data } = await res.json(); // { id }

import os, requests

res = requests.post(
    "https://api.tomba.io/v1/bulk/author",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Author Finder job",
      "list": "https://piedpiper.com/blog/middle-out-compression",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

// 01 · requête

Bulk Author Finder tient en une requête HTTPS

Envoyez les paramètres avec votre clé et votre secret. Chaque SDK, la CLI et le serveur MCP effectuent ce même appel.

type: author
list | data | file: Article URLs
launch: true lance la tâche immédiatement
webhook_url: Reçoit un événement signé à la fin de la tâche
rows: Jusqu'à 5,000 par tâche

POST /bulk/author

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"}'

const res = await fetch("https://api.tomba.io/v1/bulk/author", {
  method: "POST",
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "Author Finder job",
    "list": "https://piedpiper.com/blog/middle-out-compression",
    "launch": true,
    "webhook_url": "https://hooks.example.com/tomba"
  })
});
const { data } = await res.json(); // { id }

import os, requests

res = requests.post(
    "https://api.tomba.io/v1/bulk/author",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Author Finder job",
      "list": "https://piedpiper.com/blog/middle-out-compression",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

// 02 · réponse

Ce qui est renvoyé

Du JSON, identique dans tous les langages. Les champs que Tomba ne connaît pas valent null, jamais une supposition.

GET/author-finderChamp

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

POST /bulk/author

201 Created

{
  "data": {
    "id": 1042
  }
}

Chaque ligne, telle que GET /author-finder la renvoie

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 · coût et limites

Ce que coûte un appel

Un appel n'est facturé que dans la condition ci-dessous. Les limites de débit dépendent de votre offre.

// coût

1 search credit per article with an author address.

Charged once, at the first download; later downloads are free

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)

// faq

Foire aux questions

D'autres questions ? Consultez le centre d'aide

Votre premier appel en une minute

Compte gratuit, vraie clé API, les mêmes endpoints que ceux qu'utilisent les clients Enterprise.

1Créez un compte gratuit25 recherches par mois. Sans carte bancaire.

2Copiez votre clé et votre secretDepuis Clés API dans le tableau de bord.

3Appelez l'APICollez la requête ; la réponse est en JSON.

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY } }); const { data } = await res.json();

import os, requests res = requests.get( "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", headers={ "X-Tomba-Key": os.environ["TOMBA_API_KEY"], "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"], }, ) data = res.json()["data"]

{ "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": [] } }

API de recherche d'auteurs en masse

Bulk Author Finder tient en une requête HTTPS

Ce qui est renvoyé

Ce que coûte un appel

Endpoints associés

Foire aux questions

Votre premier appel en une minute