// get /v1/author-finder
API Recherche d'Auteur
Trouvez l'adresse email vérifiée et le profil complet de n'importe quel auteur d'article ou de billet de blog à partir d'une URL.
1 search credit
// console api
ExempleExemple de réponse tiré de la référence de l'API
- 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 · requête
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.
GET
/author-finderurlobligatoire- The article URL
curl -G https://api.tomba.io/v1/author-finder \
--data-urlencode "url=https://piedpiper.com/blog/middle-out-compression" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
url: "https://piedpiper.com/blog/middle-out-compression"
});
const res = await fetch(`https://api.tomba.io/v1/author-finder?${params}`, {
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/author-finder",
params={
"url": "https://piedpiper.com/blog/middle-out-compression",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 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-finderdata.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 · 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
1search credit
Facturé quand: An address is returned.
Les erreurs, les réponses 429 et 451, ainsi que la même requête répétée dans votre fenêtre d'utilisation ne coûtent rien.
Comment fonctionnent les crédits// limites de débit
Requêtes par seconde / minute / jour| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Faites défiler horizontalement pour voir toutes les colonnes
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. Limites de débit
Passez n'importe quelle URL d'article ou de billet de blog. Tomba extrait le nom de l'auteur à partir des signatures, des balises meta et du balisage schema, puis le croise avec notre base de données pour trouver son email vérifié.
Email de l'auteur, score de confiance, nom complet, titre de poste, entreprise, département, ancienneté, LinkedIn, Twitter, numéro de téléphone et URL sources.
Billets de blog, articles de presse, publications Medium et toute page avec une signature d'auteur visible ou des données structurées d'auteur.
Oui. L'API Recherche d'Auteur en Masse traite des centaines d'URL à la fois via import CSV.
Non. Les crédits ne sont consommés que lorsqu'un email d'auteur valide est trouvé. Rien n'est facturé pour les articles dont l'auteur ne peut pas être identifié.
Tomba extrait les données de l'auteur à partir de plusieurs signaux : balises meta, balisage schema.org, signatures et structure de la page. Chaque résultat comprend un indice de confiance.
13 SDK officiels : C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby et Rust. Ou utilisez directement l'API REST.
Les données de l'auteur sont extraites de la partie publique de la page. Si la signature et les balises meta sont visibles sans abonnement, Author Finder fonctionnera.