// get /v1/author-finder
Author Finder API
Vind het geverifieerde e-mailadres en volledige profiel van elke auteur van een artikel of blogpost via een URL.
1 search credit
// api-console
VoorbeeldVoorbeeldantwoord uit de API-naslag
- 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 · verzoek
Author Finder is één HTTPS-verzoek
Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.
GET
/author-finderurlverplicht- 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 · antwoord
Wat je terugkrijgt
JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.
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 · kosten en limieten
Wat een aanroep kost
Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.
// kosten
1search credit
In rekening gebracht als: An address is returned.
Fouten, 429- en 451-antwoorden en hetzelfde verzoek opnieuw binnen je gebruiksvenster kosten niets.
Hoe credits werken// rate limits
Verzoeken per seconde / minuut / dag| 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 |
Scroll opzij voor alle kolommen
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
Voer een artikel- of blogpost-URL in. Tomba extraheert de auteursnaam uit bijschriften, metatags en schema-markup en matcht deze vervolgens met onze database om hun geverifieerde e-mail te vinden.
Auteurs-e-mail, betrouwbaarheidsscore, volledige naam, functietitel, bedrijf, afdeling, senioriteit, LinkedIn, Twitter, telefoonnummer en bron-URL's.
Blogposts, nieuwsartikelen, Medium-posts en elke pagina met een zichtbaar auteursbijschrift of gestructureerde auteursgegevens.
Ja. De Bulk Author Finder API verwerkt honderden URL's tegelijk via CSV-upload.
Nee. Credits worden alleen verbruikt als er een geldig e-mailadres van de auteur wordt gevonden. Artikelen waarvan de auteur niet te achterhalen is, kosten niets.
Tomba haalt auteursgegevens uit meerdere signalen, waaronder metatags, schema.org-markup, bylines en de paginastructuur. Elk resultaat bevat een betrouwbaarheidsscore.
13 officiële SDK's: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby en Rust. Of gebruik de REST API rechtstreeks.
Auteursgegevens worden gehaald uit het openbaar zichtbare deel van de pagina. Zijn de byline en metatags zonder abonnement zichtbaar, dan werkt Author Finder.