Brand API

Endpunkt

Schnellstart

curl "https://api.vectorup.dev/v1/brands/AAPL?token=YOUR_TOKEN"

Der Identifikator kann ein Börsenticker, ein Firmenname, eine Domain oder der Name eines Superinvestors sein:

Parameter

Antwort

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
  }
}

Felder

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.

Felder nur für Superinvestoren

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

Caching

Die Antworten enthalten Cache-Control: public, max-age=3600 - die Daten werden für eine Stunde zwischengespeichert.

CORS

Alle Endpunkte geben Access-Control-Allow-Origin: * zurück, sodass du die API von jeder browserbasierten Anwendung aus aufrufen kannst.

Fehler

• 401 — Fehlendes oder ungültiges Token
• 404 — Kennung nicht gefunden
• 429 — Monatliche Quote überschritten

Anfragelimits

Die Anfragen werden pro Kalendermonat für alle API-Schlüssel deines Kontos gezählt. Wenn du deine Quote überschreitest, antwortet die API mit 429. Überprüfe deine Nutzung im .