API Reference

Brand API

Structured company data as JSON — name, logo URL, headquarters, and more.

API Playground

Try it live — each call uses your quota

Checking authentication...

Company / Ticker

Click "Send Request" to see the response

Quick Start

GET /api/logos/{identifier}/info?token=YOUR_TOKEN

curl "https://api.vectorup.dev/api/logos/AAPL/info?token=YOUR_TOKEN"

The identifier can be a stock ticker, company name, or domain. The API automatically resolves it.

Identifier	Example
Stock ticker	`/api/logos/AAPL/info`
Company name	`/api/logos/McDonald's/info`
Domain	`/api/logos/apple.com/info`

The Brand API requires a paid plan. See plans.

Authentication

Pass your publishable token as a query parameter:

/api/logos/AAPL/info?token=pk_...

Example Response

{
  "name": "Apple Inc.",
  "symbol": "AAPL",
  "type": "stock",
  "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers...",
  "logo": "https://img.vectorup.dev/ticker/AAPL",
  "website": "https://apple.com",
  "industry": "Consumer Electronics",
  "sector": "Technology",
  "ceo": "Tim Cook",
  "employees": "164000",
  "founded": "1980-12-12",
  "headquarters": {
    "city": "Cupertino",
    "state": "California",
    "country": "US"
  },
  "exchange": "NASDAQ Global Select",
  "isin": "US0378331005",
  "market_cap": 3200000000000,
  "currency": "USD",
  "is_actively_trading": true
}

Response Fields

Every response includes name, type, logo, and description. Additional fields depend on the entity type.

Field	Type	Present on
`name`	string	all
`type`	string	all — `"stock"` or `"merchant"`
`logo`	string	all
`description`	string	all
`website`	string	all
`headquarters`	object	all — `city`, `state`, `country`
`employees`	string	all
`industry`, `sector`	string	stocks
`ceo`	string	stocks
`exchange`, `isin`, `currency`	string	stocks
`market_cap`, `price`	number	stocks
`is_actively_trading`	boolean	stocks
`founded`, `founders`	string / string[]	merchants
`key_people`	object[]	merchants — `name` + `role`
`social_media`	object[]	merchants
`wikipedia`	string	merchants

Fields that don't apply or have no data are returned as null.

Errors

401 — Missing or invalid token
404 — Identifier not found
429 — Monthly quota exceeded

Previous: Logo API Next: Rate Limits