// get /v1/author-finder
API do Buscador de autor
Encontre o endereco de email verificado e perfil completo de qualquer autor de artigo ou publicacao de blog a partir de um URL.
1 search credit
// console da api
ExemploExemplo de resposta da referência da 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 · requisição
Author Finder é uma requisição HTTPS
Envie os parâmetros com sua chave e seu secret. Todos os SDKs, a CLI e o servidor MCP fazem esta mesma chamada.
GET
/author-finderurlobrigatório- 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 · resposta
O que volta
JSON, igual em todas as linguagens. Campos que a Tomba não conhece vêm como null, nunca adivinhados.
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 · custo e limites
Quanto custa uma chamada
Uma chamada só é cobrada na condição abaixo. Os limites de requisições dependem do seu plano.
// custo
1search credit
Cobrado quando: An address is returned.
Erros, respostas 429 e 451, e a mesma requisição repetida dentro da sua janela de uso não custam nada.
Como os créditos funcionam// limites de requisições
Requisições por segundo / minuto / dia| 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 |
Role para o lado para ver todas as colunas
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 requisições
// perguntas frequentes
Perguntas sobre a API do Buscador de autor
Ainda tem dúvidas? Visite a central de ajuda
Passe qualquer URL de artigo ou publicacao de blog. O Tomba extrai o nome do autor a partir de linhas de autoria, meta tags e schema markup, e depois cruza-o com a nossa base de dados para encontrar o seu email verificado.
Email do autor, pontuacao de confianca, nome completo, cargo, empresa, departamento, senioridade, LinkedIn, Twitter, numero de telefone e URLs de fontes.
Publicacoes de blog, artigos de noticias, publicacoes do Medium e qualquer pagina com uma linha de autoria visivel ou dados estruturados do autor.
Sim. A API de Busca de Autor em Massa processa centenas de URLs de uma vez atraves de upload CSV.
Não. Os créditos só são consumidos quando um email de autor válido é encontrado. Não há cobrança para artigos cujo autor não pode ser identificado.
A Tomba extrai os dados do autor de vários sinais, como meta tags, marcação schema.org, assinaturas e estrutura da página. Cada resultado inclui uma pontuação de confiança.
13 SDKs oficiais: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby e Rust. Ou use a API REST diretamente.
Os dados do autor são extraídos da parte da página visível publicamente. Se a assinatura do autor e as meta tags estiverem visíveis sem assinatura paga, o Buscador de autor funciona.