// operations en masse
Recherche d'Auteurs en Masse
Importez un CSV d'URLs d'articles et trouvez toutes les adresses e-mail des auteurs en une seule fois.
Article URLsJusqu'à 5,000 lignes par tâcheCSV, liste ou lignes
author-finder-list.csv2,500 lignes · article urlscompleted
Author Finder en masse · /bulk/author2,500 / 2,500
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: trueprogression interrogée avec GET /v1/bulk/author/1042/progress - 03completed
bulk.completedwebhook signé envoyé à votre webhook_url
GET /v1/bulk/author/1042/download?file=fullFacturé au premier téléchargement · la tâche expire au bout de 180 jours// 01 · entrée
L'entrée d'une tâche Author Finder en masse
Importez un CSV de 4 Mo maximum dans l'application, ou envoyez une liste, des lignes ou un fichier à POST /v1/bulk/author. Les colonnes sont détectées à partir de la ligne d'en-tête ; indiquez un index de champ pour en choisir une vous-même.
POST
/bulk/authorColonnesurl_field_index- Article URL
POST
/bulk/authorOptionsinclude_sources- true adds the web pages where each address was found
// 02 · api
Une seule requête lance la tâche
Créez-la et lancez-la en un seul appel, puis suivez sa progression ou recevez un événement bulk.completed signé. Chaque ligne de résultat correspond à ce que renvoie GET /author-finder.
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"]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 une tâche
La création ou le lancement d'une tâche ne coûte rien. Son coût est facturé une seule fois, au premier téléchargement des résultats.
// facturation par ligne
1 search credit per article with an author address.
La facturation des tâches en masse dans la documentation- Lignes : jusqu'à 5,000 par tâche
- 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)
// 04 · utilisable partout
Lancez des tâches Author Finder depuis l'application ou votre code
La même tâche, les mêmes crédits : importez un fichier dans l'application, appelez l'API, ou travaillez depuis un tableur ou un outil no-code.
- API RESTJSON sur HTTPS, 13 SDK, webhooks signés.
GET /v1/author-finder - CSV en masseImportez une liste dans l'application ou envoyez-la en POST à /bulk ; téléchargez-la une fois terminée.
POST /v1/bulk/{type} - Google Sheets et ExcelDes formules et une barre latérale qui appellent les mêmes endpoints.
=TOMBA_AUTHOR(A2) - Zapier, Make, n8nDes actions no-code pour la recherche, la vérification et l'enrichissement.
Zapier · Make · n8n · Pipedream
La référence complète de la requête : /api/bulk/author-finder
// clients
Les équipes qui lancent des tâches Author Finder
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, VizmeTomba 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
La Recherche d'Auteurs en Masse est un outil specialise pour extraire des adresses e-mail a partir d'une liste d'URLs d'articles. Pour tester son fonctionnement, des recherches individuelles peuvent etre effectuees avec le Recherche d'Auteurs.
Le Recherche d'Auteurs obtient des adresses e-mail disponibles publiquement sur le web. Pour aider a determiner la precision de ces e-mails, chacun se voit attribuer un score de confiance base sur des facteurs tels que la credibilite de la source, les verifications SMTP et le contexte des pages web.
L'acces a la Recherche d'Auteurs en Masse est accorde via un compte gratuit, avec differents plans selon vos besoins en nombre de requetes. Un essai est possible avant de s'engager dans une mise a niveau. Vous pouvez importer un fichier CSV pour examiner le volume et la qualite des adresses e-mail trouvees, estimer le nombre de requetes necessaires et obtenir un apercu des donnees. Les abonnements peuvent etre resilies a tout moment.