Get one brand
curl --request GET \
--url https://app.spyglass.so/api/v1/brands/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.spyglass.so/api/v1/brands/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.spyglass.so/api/v1/brands/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "<string>",
"name": "<string>",
"summary": "<string>",
"category": "<string>",
"verified": true,
"pageAlias": "<string>",
"likes": 123,
"igUsername": "<string>",
"igFollowers": 123,
"igEngagementRate": 123,
"tiktokUsername": "<string>",
"tiktokFollowers": 123,
"thumbnailUrl": "<string>"
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}Lookup
Get one brand
Fetch a single brand by id. Use this when you already have an id and just want the brand record — /brands/search is for resolving an id you do not have yet.
Limited to 120 requests per minute for this endpoint. Costs 2,500 microdollars ($0.0025) per brand returned, charged against your plan’s monthly credits. The response is a bare brand with no count field, because a successful lookup is always exactly one row. An id that matches nothing returns 404 and is free.
GET
/
brands
/
{id}
Get one brand
curl --request GET \
--url https://app.spyglass.so/api/v1/brands/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.spyglass.so/api/v1/brands/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.spyglass.so/api/v1/brands/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "<string>",
"name": "<string>",
"summary": "<string>",
"category": "<string>",
"verified": true,
"pageAlias": "<string>",
"likes": 123,
"igUsername": "<string>",
"igFollowers": 123,
"igEngagementRate": 123,
"tiktokUsername": "<string>",
"tiktokFollowers": 123,
"thumbnailUrl": "<string>"
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}Authorizations
An API key from Settings → API, prefixed sg_live_.
Path Parameters
Brand id returned by POST /brands/search.
Response
The brand.