// operazioni in blocco
Ricerca Autori in Blocco
Carica un CSV con URL di articoli e trova tutti gli indirizzi email degli autori in una volta sola.
Article URLsFino a 5,000 righe per jobCSV, lista o righe
author-finder-list.csv2,500 righe · article urlscompleted
Author Finder in blocco · /bulk/author2,500 / 2,500
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: trueavanzamento interrogato con GET /v1/bulk/author/1042/progress - 03completed
bulk.completedwebhook firmato consegnato al tuo webhook_url
GET /v1/bulk/author/1042/download?file=fullAddebitato al primo download · il job scade dopo 180 giorni// 01 · input
L'input di un job Author Finder in blocco
Carica nell'app un CSV fino a 4 MB, oppure invia una lista, delle righe o un file a POST /v1/bulk/author. Le colonne vengono individuate dalla riga di intestazione; imposta un indice di campo per sceglierne una tu stesso.
POST
/bulk/authorColonneurl_field_index- Article URL
POST
/bulk/authorOpzioniinclude_sources- true adds the web pages where each address was found
// 02 · api
Una richiesta avvia il job
Crealo e avvialo con una sola chiamata, poi seguine l'avanzamento o ricevi un evento firmato bulk.completed. Ogni riga di risultato è ciò che restituisce 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
}
}Ogni riga, come la restituisce GET /author-finder
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 · costi e limiti
Quanto costa un job
Creare o avviare un job non costa nulla. Il costo viene addebitato una sola volta, al primo download dei risultati.
// fatturazione per riga
1 search credit per article with an author address.
Fatturazione dei job in blocco nella documentazione- Righe: fino a 5,000 per job
- 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 · usalo ovunque
Esegui job Author Finder dall'app o dal tuo codice
Lo stesso job, gli stessi crediti: carica un file nell'app, chiama l'API o lavora da un foglio di calcolo o da uno strumento no-code.
- API RESTJSON su HTTPS, 13 SDK, webhook firmati.
GET /v1/author-finder - CSV in bloccoCarica una lista nell'app o inviala con POST a /bulk; scaricala quando è pronta.
POST /v1/bulk/{type} - Google Sheets ed ExcelFormule e una barra laterale che chiamano gli stessi endpoint.
=TOMBA_AUTHOR(A2) - Zapier, Make, n8nAzioni no-code per finder, verifier e arricchimento.
Zapier · Make · n8n · Pipedream
Il riferimento completo della richiesta: /api/bulk/author-finder
// clienti
Team che eseguono job 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 Ricerca Autori in Blocco è uno strumento specializzato per estrarre indirizzi email da una raccolta di URL di articoli. Per provare come funziona, è possibile effettuare ricerche individuali utilizzando la Ricerca Autori.
La Ricerca Autori trova indirizzi email disponibili pubblicamente sul web. Per aiutarti a determinare l'accuratezza di queste email, a ciascuna viene assegnato un punteggio di affidabilità basato su fattori come la credibilità della fonte, le verifiche SMTP e il contesto circostante sulle pagine web.
L'accesso alla Ricerca Autori in Blocco è disponibile tramite un account gratuito, con vari piani a seconda del numero di richieste necessarie. È possibile effettuare una prova prima di passare a un piano superiore. Puoi caricare un file CSV per verificare il volume e la qualità degli indirizzi email trovati, stimare il numero di richieste necessarie e ottenere un'anteprima dei dati. Gli abbonamenti possono essere annullati in qualsiasi momento.