// get /v1/author-finder
API Author Finder
Trova l'indirizzo email verificato e il profilo completo di qualsiasi autore di articoli o post di blog da un URL.
1 search credit
// console api
EsempioEsempio di risposta dal riferimento 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 · richiesta
Author Finder è una sola richiesta HTTPS
Invia i parametri con la tua chiave e il tuo secret. Ogni SDK, la CLI e il server MCP fanno questa stessa chiamata.
GET
/author-finderurlobbligatorio- 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 · risposta
Cosa ricevi
JSON, uguale in ogni linguaggio. I campi che Tomba non conosce sono null, mai indovinati.
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 · costi e limiti
Quanto costa una chiamata
Una chiamata viene addebitata solo alla condizione indicata sotto. I limiti di frequenza dipendono dal tuo piano.
// costo
1search credit
Addebitato quando: An address is returned.
Errori, risposte 429 e 451 e la stessa richiesta ripetuta entro la tua finestra di utilizzo non costano nulla.
Come funzionano i crediti// limiti di frequenza
Richieste al secondo / minuto / giorno| 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 |
Scorri in orizzontale per vedere tutte le colonne
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. Limiti di frequenza
Inserisci qualsiasi URL di articolo o post di blog. Tomba estrae il nome dell'autore dalle firme, meta tag e markup schema, poi lo confronta con il nostro database per trovare la sua email verificata.
Email dell'autore, punteggio di affidabilita, nome completo, titolo lavorativo, azienda, reparto, anzianita, LinkedIn, Twitter, numero di telefono e URL delle fonti.
Post di blog, articoli di notizie, post Medium e qualsiasi pagina con una firma dell'autore visibile o dati strutturati sull'autore.
Si. L'API Bulk Author Finder elabora centinaia di URL contemporaneamente tramite caricamento CSV.
No. I crediti vengono consumati solo quando si trova un'email valida dell'autore. Nessun addebito per gli articoli in cui l'autore non può essere identificato.
Tomba estrae i dati dell'autore da più segnali, tra cui meta tag, markup schema.org, firme e struttura della pagina. Ogni risultato include un punteggio di affidabilità.
13 SDK ufficiali: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby e Rust. Oppure usa direttamente l'API REST.
I dati dell'autore vengono estratti dalla parte della pagina visibile pubblicamente. Se la firma dell'autore e i meta tag sono visibili senza abbonamento, Author Finder funziona.