> ## 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

> 通过域名免费查询公司 Logo 的公开 API。使用简单的 URL 在 CRM、仪表板、营销页面或序列中嵌入公司 Logo —— 无需 API 密钥。

Pubrio Logo API 通过域名返回公司 Logo。无需 API 密钥。无需注册。只需一个 URL。

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

<Frame>
  <img src="https://logo.pubrio.com/pubrio.com" alt="Pubrio Logo 示例" width="120" />
</Frame>

## 快速开始

<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}`;
  // 直接用于 <img src> 或获取二进制数据
  ```

  ```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>

## 端点

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

| 参数       | 位置   | 必需 | 描述                                                         |
| -------- | ---- | -- | ---------------------------------------------------------- |
| `domain` | path | ✅  | 公司域名（例如 `stripe.com`、`apple.com`）。可带或不带 `www.`；如果包含协议会被忽略。 |

**响应：** Logo 图像二进制数据，通过相应的 `Content-Type` 标头返回。

<Note>
  无需身份验证。无 `Authorization` 标头、无 API 密钥、无签名 URL。可在生产环境中直接通过 `<img src>` 热链接。
</Note>

## 工作原理

<CardGroup cols={2}>
  <Card title="按域名查询" icon="globe">
    在 URL 路径中提供任何公司域名。Pubrio 解析规范品牌并从持续刷新的源集中返回其 Logo。
  </Card>

  <Card title="CDN 分发" icon="bolt">
    Logo 在边缘节点缓存。首次请求预热缓存；后续请求由最近的 POP 提供，延迟低于 100 毫秒。
  </Card>

  <Card title="无需身份验证" icon="lock-open">
    公开端点。可直接嵌入 `<img src>` 标签、营销网站、潜在客户挖掘工具、仪表板或浏览器扩展中。
  </Card>

  <Card title="优雅回退" icon="image">
    未知或无法解析的域名返回中性占位图，而非损坏的图像 —— 您的 UI 永远不会显示缺失资源图标。
  </Card>
</CardGroup>

## 示例

<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>

## 常见用例

<CardGroup cols={2}>
  <Card title="CRM 和潜在客户挖掘 UI" icon="users">
    在 CRM、销售工具或 BI 仪表板中的公司记录旁显示 Logo —— 无需上传、存储或维护 Logo 资源库。
  </Card>

  <Card title="邮件签名和序列" icon="envelope">
    在个性化外发邮件中嵌入收件人的公司 Logo —— 每次发送都从 CDN 获取最新 Logo。
  </Card>

  <Card title="投资人仪表板和投资组合页面" icon="chart-line">
    按域名渲染公司网格。适用于不在主流图库中的上市、私营、初创或国际公司。
  </Card>

  <Card title="营销页面和案例研究" icon="grid">
    客户 Logo 墙、集成网格、"信赖于我们的客户" 部分 —— 直接由域名列表驱动。
  </Card>
</CardGroup>

## 从其他 Logo 提供商迁移

如果您现有的 Logo URL 遵循 `host/{domain}` 模式，切换到 Pubrio 只需一行查找替换。

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

  ```js JavaScript theme={null}
  // 在现有辅助函数中替换主机名
  const logo = `https://logo.pubrio.com/${domain}`;
  ```
</CodeGroup>

URL 形式相同、响应契约相同（按域名返回图像二进制）、无需身份验证 —— 大多数代码库的迁移只需替换一个字符串。

## 常见问题

<AccordionGroup>
  <Accordion title="我需要 API 密钥吗？">
    不需要。Logo API 是公开免费的。您可以在客户端 HTML、营销页面、仪表板和扩展中通过 `<img src>` 热链接图像，无需任何凭据。
  </Accordion>

  <Accordion title="如果域名不存在或没有 Logo 会怎样？">
    未知或无法解析的域名返回中性占位图而非 404 —— 您的 UI 保持整洁。如果您需要以编程方式检测"未找到 Logo"，请检查响应标头。
  </Accordion>

  <Accordion title="返回什么图像格式？">
    Pubrio 返回每个品牌可用的最高质量格式（通常是带透明度的 PNG）。`Content-Type` 标头反映实际提供的格式。
  </Accordion>

  <Accordion title="有速率限制吗？">
    该端点专为页内热链接和大流量 CDN 分发而设计。普通浏览器使用没有按 IP 的速率限制。服务器到服务器的批量爬取会受到合理使用限流 —— 如果您有大流量后端用例,请联系我们。
  </Accordion>

  <Accordion title="可以在生产网站上使用吗？">
    可以 —— 这就是主要用例。直接嵌入 `<img src="https://logo.pubrio.com/{domain}">`。Logo 在边缘缓存以实现全球快速分发。
  </Accordion>

  <Accordion title="Logo 多久更新一次？">
    Pubrio 持续从规范品牌源重新获取和刷新 Logo。大多数 Logo 在品牌变更后数天内更新。
  </Accordion>

  <Accordion title="这是否需要 Pubrio API 的其他部分？">
    不需要。Logo API 是独立的免费服务。如果您还需要公司数据丰富、员工数量、信号或联系数据，请参阅[主 API 参考](/cn/api-reference/introduction)。
  </Accordion>
</AccordionGroup>

## 超越 Logo：完整的 Pubrio API

Logo API 是一项免费实用工具。如果您觉得有用,Pubrio 平台的其余部分可将同一域名转化为完整的公司档案。

<CardGroup cols={2}>
  <Card title="公司数据丰富" icon="building" href="/cn/api-reference/endpoint/companies/enrichment">
    将域名解析为员工数量、行业、位置、技术栈等。
  </Card>

  <Card title="人员查询" icon="user" href="/cn/api-reference/endpoint/people/lookup">
    按角色、资历或部门查找任何公司的已验证联系人。
  </Card>

  <Card title="Monitors（信号）" icon="bolt" href="/cn/api-reference/endpoint/monitors/monitors">
    通过 Webhook 实时交付招聘、新闻和广告信号。
  </Card>

  <Card title="获取 API 密钥" icon="key" href="https://dashboard.pubrio.com">
    免费计划含信用额度 —— 无需信用卡。
  </Card>
</CardGroup>