`https://cdn.brandfetch.io/brandfetch.com?c={your-client-id-here}`
It’s customizable with powerful transformation capabilities and is meant to be directly embedded in your HTML tags so the logo always remains up-to-date.
**Key features:**
* **Rich taxonomy:** Access not just logo icons, but also brand symbols and main horizontal logos.
* **Theme support:** Access dark or light logos so you can display them on any background.
* **Customizable sizing:** Adjust the logo’s height and width to fit your needs.
* **Smart fallbacks:** Even when a logo isn’t available, you’ll get fallbacks.
* **Stay on-brand:** Logo Link automatically updates to the latest brand logo, so you’re always on-brand.
Best of all? [It’s free with attribution](/docs/logo-link/guidelines).
Get started by trying the [query builder](https://brandfetch.com/developers/logo-api) and reading the [documentation](/docs/logo-link/).
## Brand Quality Score
We now score brands on quality and make the score available via the Brands API. The quality score is a float between 0-1 which indicates the quality of the data for the given brand. The score is useful for when you don't want to show lower quality brands to your users.
Each brand now has a new `qualityScore` attribute with it's respective score:
```json
{
"name": "Brandfetch",
"domain": "brandfetch.com",
"qualityScore": 0.7599741515319993,
...
}
```
The score is engineered to divide into thirds: Lower 3rd is poor quality, middle 3rd is OK quality, upper 3rd is high quality. Lower scores indicate that a brand is less likely to be a "real" brand. For example, where google.com will score high, my-random-blog.com will score between 0.3-0.4. The score factors in things like data-recency, whether the brand has been claimed, if it has been manually verified by our team, the brand's domain ranking on the web, as well as other factors.
The score can be used to sort multiple brands in a list to determine which brand may be the best option to show to a user.
The way we calculate this score may change over time such that a score for a given brand may change, but will remain aligned such that it divides quality into thirds: low, medium, high.
## Brand Firmographics
We've added a few firmographic attributes to brands on the Brands API. The new attributes: number of employees, year founded, industry categorization, company kind, and geographic information about the brand's company headquarters.
```json
{
"name": "Stripe",
"domain": "stripe.com",
"company": {
"employees": 1001,
"foundedYear": 2010,
"industries": [
{
"score": 1,
"id": "37",
"name": "Programming and Developer Software",
"emoji": "🖥",
"parent": {
"emoji": "🖥",
"id": "28",
"name": "Computers Electronics and Technology",
"slug": "computers-electronics-and-technology"
},
"slug": "programming-and-developer-software"
},
{
"score": 1,
"id": "28",
"name": "Computers Electronics and Technology",
"emoji": "🖥",
"parent": null,
"slug": "computers-electronics-and-technology"
}
],
"kind": "PRIVATELY_HELD",
"location": {
"city": "South San Francisco",
"country": "United States",
"countryCode": "US",
"region": "Americas",
"state": "California",
"subregion": "Northern America"
},
},
...
}
```
More details on the available attributes can be found in the API documentation [here](/reference/brand-api).
## Brand is NSFW?
We've added a `isNsfw` convenience attribute to the root of the brand object on the Brands API response. When the value of `isNsfw` is `true`, we're indicating that we believe the brand to be, contain, or relate to adult content such as pornography (both photographic and animated) as well as adult-related like online sex shops.
```json
{
"name": "Example",
"domain": "adult-content.xxx",
"isNsfw": true,
...
}
```
## Brand industry classifications
We now classify brands into one or more industry categories and make this data available through the Brands API. The industry is returned on brands' company attribute:
```json
{
"name":"Stripe",
"domain": "stripe.com",
"company": {
"industries": [
{
"score": 1,
"id": "37",
"name": "Programming and Developer Software",
"emoji": "🖥",
"parent": {
"emoji": "🖥",
"id": "28",
"name": "Computers Electronics and Technology",
"slug": "computers-electronics-and-technology"
},
"slug": "programming-and-developer-software"
},
{
"score": 1,
"id": "28",
"name": "Computers Electronics and Technology",
"emoji": "🖥",
"parent": null,
"slug": "computers-electronics-and-technology"
}
],
...
},
...
}
```
More details on the available attributes can be found in the [API Reference](/reference/brand-api).
In the coming weeks we will release a free Taxonomy API for retrieving our industry taxonomy. In the meantime view the complete industry list [here](https://docs.google.com/spreadsheets/d/1N44nMfVtPCFM4ebTcmRlqbyxjFtDAGVuqd0mh0dcOU0/edit?usp=sharing).
# 2025
Source: https://docs.brandfetch.com/changelog/2025
Follow along with updates across Brandfetch’s API.
## **Query by ISIN & Stock Ticker: Now available in Brand API & Logo Link**
We've expanded the capabilities of our Brand API and Logo Link endpoints. You can now query brand data directly using financial identifiers such as ISIN (e.g., `US6541061031`) or Stock Tickers (e.g., `NKE`).
Previously, website URLs or Brand IDs were the primary ways to access brand information. With this update, simply input an ISIN or Stock Ticker to easily retrieve brand details and logos, further streamlining integrations for financial and investment platforms.
Get started by reviewing the [documentation](/docs/brand-api/).
## **Transaction API: Turn payment transactions into merchant data.**
We've released a new endpoint called the Transaction API, enabling you to convert messy payment transactions into merchant data (e.g., logos, name, location, industry, etc.).
The primary input for querying the Transaction API is a raw transaction descriptor (the line-item text on a bank or credit card statement). You provide this as the `transactionLabel` in the request body, along with a `countryCode` to narrow down the merchant’s locale. For example, a transaction label like `STARBUCKS 1523 OMAHA NE` with country code `US` can be resolved to `starbucks.com`.
Get started by reading the [documentation](/docs/transaction-api/).
## **404 Fallback for Logo Link**
We have introduced a new fallback option to the Logo Link, enabling you to choose whether you want to receive a 404 response if no logo is found. This complements our existing fallback options: `transparent`, `lettermark`, and `brandfetch`.
You can access the 404 fallback in the same way as the other fallback options by specifying `404` in the link:
[`https://cdn.brandfetch.io/randomInvalidDomain.com/fallback/404/icon`](https://cdn.brandfetch.io/randomInvalidDomain.com/fallback/404/icon)
# Brand API
Source: https://docs.brandfetch.com/docs/brand-api
Data for B2B Personalization
## 🔍 Overview
Brand API provides programmatic access to any company's brand assets through a single API call. This includes their latest logos, color schemes, fonts, images, and other firmographic information. For more details, refer to our [API Reference](/reference/brand-api).
Here are a few things to know about Brand API:
* Website as input: The primary input key to query Brand API is a website
URL. If you don’t have URLs, use the [Brand Search
API](/docs/brand-search-api) to match brand names to the most likely URLs.
Additionally, you can query the Brand API directly using other identifiers such as ISIN (e.g., `US6541061031`) or Stock Ticker (e.g., `NKE`).
* Global coverage: Brand API works in real-time. If a brand is not part
of our dataset, it will index the information live, providing data for brands
of every size, geography, or sector.
* Keeping the data fresh: The cached data may not be provided or
displayed to more than one user. If you're looking to enrich large datasets,
and be notified of any changes with [Webhooks](/docs/webhooks), please [get in
touch](mailto:sales@brandfetch.io).
```
### 3. Hotlinking
```
👉 When embedding Logo Link, HTTP requests must include the `Referer` header with the request origin. Your HTTP `Referrer-Policy` header must be set to one of: `origin`, `origin-when-cross-origin`, `strict-origin`, `strict-origin-when-cross-origin` (browser default), or `unsafe-url`.
**⚠️ Programmatic access** to logo images is not permitted and may result in rate limiting or blocking. Scraping logos will also lead to a block.
If your use case requires caching, please [contact us](mailto:sales@brandfetch.io) for a custom setup.
### 4. Replicating Brandfetch
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered when a brand is claimed by the brand owner. * **Event type**: `brand.deleted`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered when a brand is soft-deleted. This is exceedingly rare and usually related to a take-down request by the brand's owner. * **Event type**: `brand.updated`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered anytime a brand's data is updated. * **Event type**: `brand.company.updated`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered anytime a brand's company data is updated. * **Event type**: `brand.verified`
**Namespace**: `brand`
**Scope**: `urn:brandfetch:brand:
**Description**: Triggered when a brand's data is human-reviewed (by our curation team). # Overview Source: https://docs.brandfetch.com/docs/webhooks/overview Get notified of changes by receiving events at your webhook URL.
{fallbackText}
***
**You're all set! You can now view our GraphQL schema. 🙌**
## We're here to help!
If you have any questions or run into any issues, just drop us an [email](mailto:support@brandfetch.io).
# Overview
Source: https://docs.brandfetch.com/reference/overview
Learn about Brandfetch's API endpoints.
This documentation provides detailed information about our API endpoints, allowing you to integrate brand data seamlessly into your applications.
Our API is divided into two main categories:
* [Brand API](/reference/brand-api): Retrieve comprehensive brand data.
* [Brand Search API](/reference/brand-search-api): Find and search brands
by name, view [usage terms](/docs/brand-search-api#guidelines).
* [Transaction API](/reference/transaction-api): Turn payment transactions into merchant data.
For detailed information on usage, tutorials and guidelines, please refer to the specific [User Guides](/docs/getting-started).
## We're here to help!
If you have any questions or run into any issues, just drop us an [email](mailto:support@brandfetch.io).
We're excited you're here!
# Transaction API
Source: https://docs.brandfetch.com/reference/transaction-api
POST /v2/brands/transaction
Turn payment transactions into merchant data.
# Getting help
Source: https://docs.brandfetch.com/support/getting-help
Our support team is always available and willing to assist you.
## Technical Support
If you come across any questions or encounter any issues, please do not hesitate to [contact us](mailto:support@brandfetch.io).
To help us quickly identify and fix the issue, kindly provide us with the following details:
* The email address of your account.
* The URL of the call you were making when the error occurred.
* The brand you were accessing.
* The status error you were facing.
## Book a Call
If you want to ask for new features, buy additional API requests, unlock premium endpoints, or gain insights on how to make the most out of the API, [book a call](https://calendly.com/jeremy-jaq/brand-api) with us!
# Report inaccuracies
Source: https://docs.brandfetch.com/support/report-inaccuracies
Report incorrect or missing brand info.
We run an internal QA process to keep our brand library accurate and complete. If you spot missing or incorrect information in our index, you can let us know through [this form](https://airtable.com/apputCfJYpfcrY1VT/pagfWltXraNRQgyH0/form).
Every submission is manually reviewed and, if verified, the update will be reflected in our index, and we'll notify you once it's live.
# Security & SOC2
Source: https://docs.brandfetch.com/support/security-soc2
Our commitment to secure data handling and best-in-class practices.
## Overview
Given that our platform exclusively handles public data and our API does not process any PII or sensitive customer information, we have not prioritized SOC2 certification at this time. However, our enterprise customers, including leading multinational banks, continue to trust and work with us, recognizing the security context of our public-data model and our SOC2–compliant handling of internal systems and infrastructure.
### User Data & PII
* **Minimal PII Storage**: Brandfetch does not collect or store Personally Identifiable Information (PII) beyond login email addresses for passwordless authentication.
* **Logging**: We retain logs for up to 90 days for operational purposes. These may include IP addresses and User-Agent strings, which typically reflect server infrastructure rather than individual users.
### API Data Handling
* **Public Data Only**: The Brandfetch API strictly processes publicly available data tied to domain names. It does not access, store, or interact with any private or customer-owned data.
* **Data Processing Workflow**: Our API indexes, processes, and enhances publicly available brand data, making it accessible for our customers. At no point does the API interact with private data.
### Security Measures
* **Data Encryption**: We utilize AES-256 encryption for data at-rest and TLS for data in-transit, ensuring end-to-end security.
* **Secure Infrastructure**: Our development, staging, and production environments are hosted on Amazon Web Services (AWS), which offers secure, resilient hosting with 24x7 security and compliance certifications.
* **Best Development Practices**: Our software development lifecycle adheres to OWASP best practices, incorporating human review processes enhanced by AI to maintain high quality standards.
## Book a Call
Have questions about security, want to discuss enterprise usage, or need help optimizing your API integration?\
[Book a call](https://calendly.com/jeremy-jaq/brand-api) with our team to get started.
# Service status
Source: https://docs.brandfetch.com/support/service-status
Check the status of Brandfetch services.