Get up to 100 brands in one request
curl --request POST \
--url https://api.brandfetch.io/v2/brands/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"identifiers": [
"nike.com",
"https://www.spotify.com/about",
{
"type": "ticker",
"value": "NKE"
}
],
"cachedOnly": false,
"allowNsfw": true,
"palette": false,
"typography": false
}
'import requests
url = "https://api.brandfetch.io/v2/brands/batch"
payload = {
"identifiers": [
"nike.com",
"https://www.spotify.com/about",
{
"type": "ticker",
"value": "NKE"
}
],
"cachedOnly": False,
"allowNsfw": True,
"palette": False,
"typography": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
identifiers: ['nike.com', 'https://www.spotify.com/about', {type: 'ticker', value: 'NKE'}],
cachedOnly: false,
allowNsfw: true,
palette: false,
typography: false
})
};
fetch('https://api.brandfetch.io/v2/brands/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.brandfetch.io/v2/brands/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'identifiers' => [
'nike.com',
'https://www.spotify.com/about',
[
'type' => 'ticker',
'value' => 'NKE'
]
],
'cachedOnly' => false,
'allowNsfw' => true,
'palette' => false,
'typography' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.brandfetch.io/v2/brands/batch"
payload := strings.NewReader("{\n \"identifiers\": [\n \"nike.com\",\n \"https://www.spotify.com/about\",\n {\n \"type\": \"ticker\",\n \"value\": \"NKE\"\n }\n ],\n \"cachedOnly\": false,\n \"allowNsfw\": true,\n \"palette\": false,\n \"typography\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.brandfetch.io/v2/brands/batch")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"identifiers\": [\n \"nike.com\",\n \"https://www.spotify.com/about\",\n {\n \"type\": \"ticker\",\n \"value\": \"NKE\"\n }\n ],\n \"cachedOnly\": false,\n \"allowNsfw\": true,\n \"palette\": false,\n \"typography\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brandfetch.io/v2/brands/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identifiers\": [\n \"nike.com\",\n \"https://www.spotify.com/about\",\n {\n \"type\": \"ticker\",\n \"value\": \"NKE\"\n }\n ],\n \"cachedOnly\": false,\n \"allowNsfw\": true,\n \"palette\": false,\n \"typography\": false\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"identifier": "<string>",
"status": 200,
"brand": {
"id": "idL0iThUh6",
"name": "Brandfetch",
"domain": "brandfetch.com",
"claimed": true,
"description": "Brandfetch is the brand identity platform. Search any brand's official logos, colors, fonts, and company details, or use our API to power modern product experiences and AI agents.",
"logo": "https://cdn.brandfetch.io/idL0iThUh6/w/512/h/512/theme/dark/fallback/404/logo.webp?c=BRANDFETCH_CLIENT_ID&t=1741016163093",
"icon": "https://cdn.brandfetch.io/idL0iThUh6/w/128/h/128/fallback/lettermark/icon.webp?c=BRANDFETCH_CLIENT_ID&t=1792682495901",
"logos": [
{
"type": "logo",
"theme": "dark",
"formats": [
{
"format": "svg",
"src": "https://cdn.brandfetch.io/idL0iThUh6/theme/dark/logo.svg?c=BRANDFETCH_CLIENT_ID",
"width": 677,
"height": 182
}
]
}
],
"colors": [
{
"hex": "#006BFF",
"type": "accent",
"brightness": 95
},
{
"hex": "#00193E",
"type": "brand",
"brightness": 22
},
{
"hex": "#000000",
"type": "dark",
"brightness": 0
},
{
"hex": "#FFFFFF",
"type": "light",
"brightness": 255
}
],
"fonts": [
{
"name": "Poppins",
"type": "title",
"origin": "google"
},
{
"name": "Inter",
"type": "body",
"origin": "google"
}
],
"company": {
"employees": 2,
"foundedYear": 2020,
"kind": "PRIVATELY_HELD",
"location": {
"city": "Savigny",
"country": "Switzerland",
"countryCode": "CH"
}
},
"qualityScore": 0.99,
"urn": "urn:brandfetch:brand:idL0iThUh6"
},
"code": "crawl_queued",
"message": "<string>"
}
]
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "Not enough API credits remain for this batch.",
"quota": 123,
"used": 123,
"remaining": 123,
"required": 123
}Brand API
Brand API batch
Send up to 100 identifiers to POST /v2/brands/batch and get one brand result per identifier, in the order you sent them.
POST
/
v2
/
brands
/
batch
Get up to 100 brands in one request
curl --request POST \
--url https://api.brandfetch.io/v2/brands/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"identifiers": [
"nike.com",
"https://www.spotify.com/about",
{
"type": "ticker",
"value": "NKE"
}
],
"cachedOnly": false,
"allowNsfw": true,
"palette": false,
"typography": false
}
'import requests
url = "https://api.brandfetch.io/v2/brands/batch"
payload = {
"identifiers": [
"nike.com",
"https://www.spotify.com/about",
{
"type": "ticker",
"value": "NKE"
}
],
"cachedOnly": False,
"allowNsfw": True,
"palette": False,
"typography": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
identifiers: ['nike.com', 'https://www.spotify.com/about', {type: 'ticker', value: 'NKE'}],
cachedOnly: false,
allowNsfw: true,
palette: false,
typography: false
})
};
fetch('https://api.brandfetch.io/v2/brands/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.brandfetch.io/v2/brands/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'identifiers' => [
'nike.com',
'https://www.spotify.com/about',
[
'type' => 'ticker',
'value' => 'NKE'
]
],
'cachedOnly' => false,
'allowNsfw' => true,
'palette' => false,
'typography' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.brandfetch.io/v2/brands/batch"
payload := strings.NewReader("{\n \"identifiers\": [\n \"nike.com\",\n \"https://www.spotify.com/about\",\n {\n \"type\": \"ticker\",\n \"value\": \"NKE\"\n }\n ],\n \"cachedOnly\": false,\n \"allowNsfw\": true,\n \"palette\": false,\n \"typography\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.brandfetch.io/v2/brands/batch")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"identifiers\": [\n \"nike.com\",\n \"https://www.spotify.com/about\",\n {\n \"type\": \"ticker\",\n \"value\": \"NKE\"\n }\n ],\n \"cachedOnly\": false,\n \"allowNsfw\": true,\n \"palette\": false,\n \"typography\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brandfetch.io/v2/brands/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identifiers\": [\n \"nike.com\",\n \"https://www.spotify.com/about\",\n {\n \"type\": \"ticker\",\n \"value\": \"NKE\"\n }\n ],\n \"cachedOnly\": false,\n \"allowNsfw\": true,\n \"palette\": false,\n \"typography\": false\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"identifier": "<string>",
"status": 200,
"brand": {
"id": "idL0iThUh6",
"name": "Brandfetch",
"domain": "brandfetch.com",
"claimed": true,
"description": "Brandfetch is the brand identity platform. Search any brand's official logos, colors, fonts, and company details, or use our API to power modern product experiences and AI agents.",
"logo": "https://cdn.brandfetch.io/idL0iThUh6/w/512/h/512/theme/dark/fallback/404/logo.webp?c=BRANDFETCH_CLIENT_ID&t=1741016163093",
"icon": "https://cdn.brandfetch.io/idL0iThUh6/w/128/h/128/fallback/lettermark/icon.webp?c=BRANDFETCH_CLIENT_ID&t=1792682495901",
"logos": [
{
"type": "logo",
"theme": "dark",
"formats": [
{
"format": "svg",
"src": "https://cdn.brandfetch.io/idL0iThUh6/theme/dark/logo.svg?c=BRANDFETCH_CLIENT_ID",
"width": 677,
"height": 182
}
]
}
],
"colors": [
{
"hex": "#006BFF",
"type": "accent",
"brightness": 95
},
{
"hex": "#00193E",
"type": "brand",
"brightness": 22
},
{
"hex": "#000000",
"type": "dark",
"brightness": 0
},
{
"hex": "#FFFFFF",
"type": "light",
"brightness": 255
}
],
"fonts": [
{
"name": "Poppins",
"type": "title",
"origin": "google"
},
{
"name": "Inter",
"type": "body",
"origin": "google"
}
],
"company": {
"employees": 2,
"foundedYear": 2020,
"kind": "PRIVATELY_HELD",
"location": {
"city": "Savigny",
"country": "Switzerland",
"countryCode": "CH"
}
},
"qualityScore": 0.99,
"urn": "urn:brandfetch:brand:idL0iThUh6"
},
"code": "crawl_queued",
"message": "<string>"
}
]
}{
"message": "<string>"
}{
"message": "<string>"
}{
"message": "Not enough API credits remain for this batch.",
"quota": 123,
"used": 123,
"remaining": 123,
"required": 123
}Send up to 100 identifiers. Get one result per identifier, in the order you
sent them, each answered the way
GET /v2/brands/{identifier} answers it.A batch never crawls while you wait. A brand that is not indexed yet is
queued for indexing and answered 202. Request it again later.Each identifier answered 200 uses one API credit. Every other result is
free, 404 included, and an identifier repeated in one request is charged
once. Available on paid plans and with prepaid credits. See
Batch lookups.Authorizations
Body
application/json
The brands to look up. A string is read as the identifier of GET /v2/brands/{identifier}: a domain, website URL, email address, brand ID, ticker or ISIN. An object names the identifier's type, as GET /v2/brands/{type}/{identifier} does. An exchange-suffixed ticker sent as a string, such as bhp.ax, is read as a domain: send it as { "type": "ticker", "value": "BHP.AX" }.
Required array length:
1 - 100 elementsRequired string length:
1 - 2048Example:
"nike.com"
Example:
[
"nike.com",
"https://www.spotify.com/about",
{ "type": "ticker", "value": "NKE" }
]
Was this page helpful?