POST AI agent ready /v1/url-metadata

API de metadados de URL - Extraia gráfico aberto, título e favicon

Busca um URL e extrai título, descrição, tags Open Graph, tags Twitter Card, favicon, URL canônico, idioma, autor, palavras-chave e cor do tema. Útil para visualizações de links e compartilhamento social.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/url-metadata \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com"}'

When to use this API

Gere visualizações de links avançados em um aplicativo de bate-papo

Quando um usuário cola um URL em uma mensagem de bate-papo, chame esse endpoint para buscar o título, a descrição e a imagem OG. Renderize um cartão de visualização abaixo da mensagem, semelhante à forma como o link de exibição do Slack ou Discord se desenrola.

Valide tags OG antes de publicar conteúdo

Antes de compartilhar uma postagem de blog nas redes sociais, extraia suas tags OG para confirmar se o título, a descrição e a imagem estão corretos. Capture metadados ausentes ou truncados antes de serem publicados no Twitter, LinkedIn ou Facebook.

Crie um gerenciador de favoritos com metadados automáticos

Quando um usuário salva um URL em sua coleção de favoritos, preencha automaticamente o título, a descrição e a miniatura dos metadados extraídos. Evite que o usuário insira manualmente os detalhes de cada marcador.

Frequently asked questions

Este endpoint segue redirecionamentos?

Sim. O endpoint segue redirecionamentos HTTP e extrai metadados do URL de destino final. O campo status reflete o status HTTP da resposta final.

Qual é a diferença entre os campos og e twitter?

og contém metatags Open Graph (usadas pelo Facebook, LinkedIn e outros). twitter contém tags de cartão do Twitter. Muitos sites definem ambos, mas as tags do Twitter Card têm prioridade no Twitter/X quando ambos estão presentes.

Posso extrair metadados de aplicativos de página única?

O endpoint busca a resposta HTML inicial sem executar JavaScript. Se um SPA renderizar suas meta tags no lado do cliente, essas tags não aparecerão na resposta.

Existe um tempo limite para URLs lentos?

Sim. O endpoint expira após 10 segundos se o URL de destino não responder. Um tempo limite retorna um erro 400 com uma mensagem descritiva.

O que contém o campo canônico?

O campo canônico contém o valor da tag <link rel="canonical">, que indica a URL preferencial para uma página. Isso ajuda a desduplicar URLs que veiculam o mesmo conteúdo.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.