> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logo API

> Consulta pública e gratuita de logotipos de empresas por domínio. Incorpore logotipos de empresas no seu CRM, dashboards, páginas de marketing ou sequências com uma URL simples — sem necessidade de chave de API.

A Logo API da Pubrio retorna o logotipo de uma empresa a partir do seu domínio. Sem chave de API. Sem cadastro. Apenas uma URL.

```html theme={null}
<img src="https://logo.pubrio.com/pubrio.com" alt="Pubrio" />
```

<Frame>
  <img src="https://logo.pubrio.com/pubrio.com" alt="Exemplo de logotipo da Pubrio" width="120" />
</Frame>

## Início rápido

<CodeGroup>
  ```html HTML theme={null}
  <img src="https://logo.pubrio.com/stripe.com" alt="Stripe" />
  ```

  ```bash curl theme={null}
  curl -L https://logo.pubrio.com/stripe.com -o stripe-logo.png
  ```

  ```js JavaScript theme={null}
  const logoUrl = `https://logo.pubrio.com/${domain}`;
  // Use diretamente em <img src> ou obtenha o binário
  ```

  ```jsx React theme={null}
  <img src={`https://logo.pubrio.com/${company.domain}`} alt={company.name} />
  ```

  ```python Python theme={null}
  import requests
  r = requests.get(f"https://logo.pubrio.com/{domain}")
  with open("logo.png", "wb") as f:
      f.write(r.content)
  ```
</CodeGroup>

## Endpoint

```
GET https://logo.pubrio.com/{domain}
```

| Parâmetro | Em   | Obrigatório | Descrição                                                                                                     |
| --------- | ---- | ----------- | ------------------------------------------------------------------------------------------------------------- |
| `domain`  | path | ✅           | O domínio da empresa (ex.: `stripe.com`, `apple.com`). Com ou sem `www.`; o protocolo é ignorado se incluído. |

**Resposta:** o binário da imagem do logotipo, servido com o cabeçalho `Content-Type` apropriado.

<Note>
  Não é necessária autenticação. Sem cabeçalho `Authorization`, sem chave de API, sem URLs assinadas. Pode usar hotlink diretamente em `<img src>` em produção.
</Note>

## Como funciona

<CardGroup cols={2}>
  <Card title="Consulta por domínio" icon="globe">
    Informe qualquer domínio de empresa no caminho da URL. A Pubrio resolve a marca canônica e retorna seu logotipo a partir de um conjunto de fontes continuamente atualizado.
  </Card>

  <Card title="Entregue via CDN" icon="bolt">
    Os logotipos são armazenados em cache na borda. A primeira requisição aquece o cache; as seguintes são servidas pelo POP mais próximo, com latência abaixo de 100ms.
  </Card>

  <Card title="Sem autenticação" icon="lock-open">
    Endpoint público. Incorpore diretamente em tags `<img src>`, sites de marketing, ferramentas de prospecção, dashboards ou extensões de navegador.
  </Card>

  <Card title="Fallback elegante" icon="image">
    Domínios desconhecidos ou não resolvíveis retornam uma imagem de placeholder neutra em vez de uma imagem quebrada — sua UI nunca mostra um ícone de recurso ausente.
  </Card>
</CardGroup>

## Exemplos

<CardGroup cols={4}>
  <Card title="stripe.com">
    <img src="https://logo.pubrio.com/stripe.com" alt="Stripe" width="80" />
  </Card>

  <Card title="airbnb.com">
    <img src="https://logo.pubrio.com/airbnb.com" alt="Airbnb" width="80" />
  </Card>

  <Card title="shopify.com">
    <img src="https://logo.pubrio.com/shopify.com" alt="Shopify" width="80" />
  </Card>

  <Card title="github.com">
    <img src="https://logo.pubrio.com/github.com" alt="GitHub" width="80" />
  </Card>
</CardGroup>

## Casos de uso comuns

<CardGroup cols={2}>
  <Card title="CRMs e interfaces de prospecção" icon="users">
    Exiba logotipos ao lado dos registros de empresas no seu CRM, ferramentas de vendas ou dashboards de BI — sem precisar fazer upload, armazenar ou manter uma biblioteca de logotipos.
  </Card>

  <Card title="Assinaturas de e-mail e sequências" icon="envelope">
    Incorpore o logotipo da empresa do destinatário em comunicações de saída personalizadas — cada envio busca o logotipo mais recente na CDN.
  </Card>

  <Card title="Dashboards de investidores e páginas de portfólio" icon="chart-line">
    Renderize uma grade de empresas por domínio. Funciona para empresas públicas, privadas, em estágio inicial ou internacionais que não constam em bancos de imagens tradicionais.
  </Card>

  <Card title="Páginas de marketing e estudos de caso" icon="grid">
    Murais de logotipos de clientes, grades de integrações, seções "confiado por" — alimentados diretamente por uma lista de domínios.
  </Card>
</CardGroup>

## Migrando de outro provedor de logotipos

Se suas URLs de logotipo atuais seguem o padrão `host/{domain}`, migrar para a Pubrio é uma simples busca e substituição de uma linha.

<CodeGroup>
  ```diff Antes / Depois theme={null}
  - <img src="https://example-logo-host.com/stripe.com" />
  + <img src="https://logo.pubrio.com/stripe.com" />
  ```

  ```js JavaScript theme={null}
  // Substitua o host no seu helper existente
  const logo = `https://logo.pubrio.com/${domain}`;
  ```
</CodeGroup>

Mesmo formato de URL, mesmo contrato de resposta (binário de imagem por domínio), sem autenticação — para a maioria das bases de código a migração é a substituição de uma única string.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Preciso de uma chave de API?">
    Não. A Logo API é pública e gratuita. Você pode fazer hotlink de imagens a partir de `<img src>` em HTML client-side, páginas de marketing, dashboards e extensões, sem nenhuma credencial.
  </Accordion>

  <Accordion title="O que acontece se um domínio não existir ou não tiver logotipo?">
    Domínios desconhecidos ou não resolvíveis retornam uma imagem de placeholder neutra em vez de um 404 — sua UI permanece limpa. Se precisar detectar "logotipo não encontrado" programaticamente, inspecione os cabeçalhos da resposta.
  </Accordion>

  <Accordion title="Qual formato de imagem é retornado?">
    A Pubrio retorna o formato de maior qualidade disponível para cada marca (normalmente PNG com transparência). O cabeçalho `Content-Type` reflete o formato realmente servido.
  </Accordion>

  <Accordion title="Há limites de taxa?">
    O endpoint foi projetado para hotlinking em página e entrega via CDN de alto volume. Não há limites de taxa por IP para uso normal em navegador. Rastreamento em massa servidor-a-servidor está sujeito a limitação por uso justo — se você tem um caso de uso de backend de alto volume, entre em contato.
  </Accordion>

  <Accordion title="Posso usar isso no meu site em produção?">
    Sim — esse é o principal caso de uso. Incorpore `<img src="https://logo.pubrio.com/{domain}">` diretamente. Os logotipos são armazenados em cache na borda para entrega rápida em todo o mundo.
  </Accordion>

  <Accordion title="Com que frequência os logotipos são atualizados?">
    A Pubrio busca e atualiza continuamente os logotipos a partir das fontes canônicas das marcas. A maioria dos logotipos é atualizada em poucos dias após uma mudança de marca.
  </Accordion>

  <Accordion title="Isso requer o restante da API Pubrio?">
    Não. A Logo API é um serviço gratuito independente. Se você também quiser enriquecimento de empresas, contagem de funcionários, sinais ou dados de contato, veja a [referência principal da API](/pt/api-reference/introduction).
  </Accordion>
</AccordionGroup>

## Além dos logotipos: a API completa da Pubrio

A Logo API é um utilitário gratuito. Se você achar útil, o restante da plataforma Pubrio transforma o mesmo domínio em um perfil completo de empresa.

<CardGroup cols={2}>
  <Card title="Enriquecimento de empresas" icon="building" href="/pt/api-reference/endpoint/companies/enrichment">
    Resolva um domínio em contagem de funcionários, setor, localização, technographics e muito mais.
  </Card>

  <Card title="Consulta de pessoas" icon="user" href="/pt/api-reference/endpoint/people/lookup">
    Encontre contatos verificados em qualquer empresa por cargo, senioridade ou departamento.
  </Card>

  <Card title="Monitores (sinais)" icon="bolt" href="/pt/api-reference/endpoint/monitors/monitors">
    Sinais de contratação, notícias e anúncios em tempo real entregues via webhook.
  </Card>

  <Card title="Obtenha uma chave de API" icon="key" href="https://dashboard.pubrio.com">
    Plano gratuito com créditos — sem necessidade de cartão.
  </Card>
</CardGroup>
