API Reference
Brand API
The Brand API provides comprehensive data about companies, including their address, domain, founding year, and number of employees. It's designed for developers looking to integrate reliable brand information into their applications, making it easier to enhance user experiences with up-to-date brand insights.
/brands/{identifier}Brand API endpoints are available only for paid plans. If you are on a free plan, you can upgrade here.
Authentication
Brand API endpoint is authenticated using Bearer token in the Authorization header of your request. Make sure to keep this secret API token secure and do not
share it publicly. You can find yours in your account.
Authorization: Bearer: <secret-api-token>Rate Limiting
Similar to the Logo API, the Brand API implements rate limiting based on user subscription plans. To get more information about the rate limits, please refer to the pricing page.
Examples
Retrieve brand information for a stock ticker
curl --request GET \
--url https://api.BrandSearch.com/brands/AAPL \
--header 'Authorization: Bearer <secret-api-token>'Parameters
Authorization Header
| Header | Type | Description |
|---|---|---|
Authorization | string (required) | Bearer token authentication. You must provide a valid Secret API token in the Authorization header of your request. You can find yours in your account settings. |
Path Parameters
| Parameter | Type | Description |
|---|---|---|
identifier | string (required) | The domain or stock ticker for which you want to retrieve brand information. For example, apple.com or AAPL. We support all major stock exchanges worldwide. Example: "apple.com" |
Response
200 - Brand information found and returned as JSON
| Field | Type | Description |
|---|---|---|
name | string | Company name |
domain | string | Company domain |
long_name | string | Full legal company name |
short_description | string | Brief company description |
long_description | string | Detailed company description |
website | string | Company website URL |
logo | string | URL to company logo |
colors | string[] | Brand colors (hex codes) |
founded_year | string | Year company was founded |
issued_currency | string | Primary trading currency |
number_of_employees | string | Number of employees |
social_media | object | Social media links (facebook, x, instagram, linkedin, youtube, pinterest, tiktok, reddit, snapchat, discord, tumblr, vimeo) |
address | object | Company address (address1, address2, city, state, zip, country) |
gics_sector | string | GICS sector classification |
gics_industry_group | string | GICS industry group |
gics_industry | string | GICS industry |
gics_sub_industry | string | GICS sub-industry |
Example Response
{
"name": "Apple Inc.",
"domain": "apple.com",
"long_name": "Apple Inc.",
"short_description": "Technology company that designs and manufactures consumer electronics",
"website": "https://www.apple.com",
"logo": "https://img.BrandSearch.com/apple.com",
"colors": [
"#000000",
"#ffffff"
],
"founded_year": "1976",
"number_of_employees": "164000",
"social_media": {
"facebook": "https://facebook.com/apple",
"x": "https://x.com/apple",
"instagram": "https://instagram.com/apple"
},
"address": {
"address1": "One Apple Park Way",
"city": "Cupertino",
"state": "CA",
"zip": "95014",
"country": "USA"
},
"gics_sector": "Information Technology",
"gics_industry": "Technology Hardware, Storage & Peripherals"
}