Brand API

Endpoint

Quick Start

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

The identifier can be a stock ticker, company name, domain, or superinvestor name:

Parameters

Response

Responses use a unified, semantically grouped brand shape: flat identity fields (type, name, symbol, description, category, logo) followed by thematic groups — company (what the organization is), ownership, offerings, history, transport, links, images, and stock (market data, only for listed companies). Each fact appears exactly once, in its semantic home — logo URLs live in images, website URLs in links.websites. Superinvestors return a minimal type: "superinvestor" response.

Fields with no data are omitted from the response rather than returned as null. Code against field presence.

{
  "type": "stock",
  "name": "Apple Inc.",
  "symbol": "AAPL",
  "description": "Apple Inc. is an American multinational technology company …",
  "category": "consumer_electronics",
  "company": {
    "industry": "Consumer Electronics",
    "sector": "Technology",
    "industries": [
      "Consumer Electronics",
      "Technology"
    ],
    "company_type": [
      "Public"
    ],
    "founded": "April 1, 1976, in Los Altos, California, US",
    "founders": [
      "Steve Jobs",
      "Steve Wozniak",
      "Ronald Wayne"
    ],
    "ceo": "Timothy D. Cook",
    "key_people": [
      {
        "name": "Timothy D. Cook",
        "role": "CEO"
      }
    ],
    "employees": "164,000 (2025)",
    "headquarters": {
      "city": "Cupertino",
      "state": "California",
      "country": "United States",
      "countryCode": "US",
      "latitude": 37.3318,
      "longitude": -122.0083
    },
    "area_served": [
      "Worldwide"
    ]
  },
  "ownership": {
    "owner": [
      "The Vanguard Group",
      "Berkshire Hathaway",
      "BlackRock",
      "State Street Global Advisors"
    ],
    "subsidiaries": [
      "Beats Electronics",
      "Claris",
      "Apple Studios"
    ]
  },
  "offerings": {
    "products": [
      "iPhone",
      "iPad",
      "Mac",
      "Apple Watch",
      "AirPods"
    ],
    "services": [
      "App Store",
      "Apple Music",
      "iCloud",
      "Apple Pay"
    ]
  },
  "history": {
    "formerly": [
      "Apple Computer Company (1976–1977)",
      "Apple Computer, Inc. (1977–2007)"
    ]
  },
  "links": {
    "websites": [
      "https://www.apple.com"
    ],
    "wikipedia": "https://en.wikipedia.org/wiki/Apple_Inc.",
    "wikidata_qid": "Q312",
    "social_media": [
      {
        "name": "facebook",
        "url": "https://www.facebook.com/Apple"
      },
      {
        "name": "twitter",
        "url": "https://www.twitter.com/Apple"
      }
    ]
  },
  "images": {
    "logo": {
      "big": {
        "url": "https://logos.vectorup.dev/logos/merchants/big/apple-inc.svg",
        "width": 56,
        "height": 56,
        "format": "svg",
        "sizeKb": 2.1
      },
      "small": {
        "url": "https://logos.vectorup.dev/logos/merchants/small/apple-inc.svg",
        "width": 18,
        "height": 18,
        "format": "svg",
        "sizeKb": 1.8
      }
    },
    "banner": {
      "url": "https://logos.vectorup.dev/logos/merchants/banner/apple-inc.jpg"
    },
    "stock_logo": {
      "big": {
        "url": "https://logos.vectorup.dev/logos/stocks/big/AAPL.svg",
        "width": 56,
        "height": 56,
        "format": "svg"
      },
      "small": {
        "url": "https://logos.vectorup.dev/logos/stocks/small/AAPL.svg",
        "width": 18,
        "height": 18,
        "format": "svg"
      }
    }
  },
  "stock": {
    "exchange": "NASDAQ",
    "exchange_full_name": "NASDAQ Global Select",
    "exchange_logo": "https://logos.vectorup.dev/logos/exchanges/big/nasdaq.svg",
    "listings": [
      "NASDAQ Global Select",
      "Nasdaq"
    ],
    "index_memberships": [
      "Nasdaq-100 component",
      "DJIA component",
      "S&P 100 component",
      "S&P 500 component"
    ],
    "isin": "US0378331005",
    "cusip": "037833100",
    "ipo_date": "1980-12-12",
    "currency": "USD",
    "price": 250.23,
    "price_usd": 250.23,
    "change": 1.45,
    "change_percentage": 0.58,
    "market_cap_usd": 3761492983658,
    "range": "195.07-316.94",
    "percent_from_52_week_low": 59.05,
    "is_actively_trading": true
  }
}

Fields

Common fields

Present on every successful response.

company — what the organization is

ownership — who owns it, what it owns

offerings — what it sells

history — lifecycle

Only present for brands with name changes or that are no longer operating.

transport — airlines & fleets

Only present for transport companies.

links — web presence

images — media assets

stock — listing & market data

Only present when the brand is publicly traded (type: "stock"). Contains exclusively market data — company facts like the CEO or headquarters live in company. Always describes the main listing; regional tickers resolve to it.

Superinvestor-only fields

Returned when type: "superinvestor". A smaller shape — these entities represent portfolio managers and firms, not companies.

Caching

Responses include Cache-Control: public, max-age=3600 — data is cached for one hour.

CORS

All endpoints return Access-Control-Allow-Origin: *, so you can call the API from any browser-based application.

Errors

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

Rate Limits

Requests are counted per calendar month across all API keys on your account. When you exceed your quota the API responds with 429. Check your usage on the .