Company Brand Lookup

GET /v1/entities/brand takes one identifier for a company and returns its brand kit: brand and legal names, logos, current website and social profile URLs, and current categories. Send any URL the company owns:

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/brand?url=stripe.com"

Every call needs an API key or a CLI or MCP sign-in, described in Authentication.

Look Up by URL

url accepts any current URL joined to the company: its website, LinkedIn, X (Twitter), Crunchbase, GitHub, or another profile, or its aVenture page. The lookup ignores the scheme (http or https), a leading www., and the case of the host. These all return Stripe:

A different path is a different URL: stripe.com/payments does not match stripe.com. The same input always returns the same company.

URL-encode a URL that carries a path or its own query string:

curl -G -H "Authorization: Bearer $AUTH_TOKEN" \
  --data-urlencode "url=https://www.linkedin.com/company/stripe" \
  "https://api.aventure.vc/v1/entities/brand"

Look Up by Slug or ID

When you already hold the company’s aVenture slug or UUID, send it instead of a URL. Send exactly one of url, slug, or entityId.

curl -H "Authorization: Bearer $AUTH_TOKEN" \
  "https://api.aventure.vc/v1/entities/brand?slug=stripe-south-san-francisco-ca-us"

Read the Response

The response is an EntityBrand. This abridged example is Stripe’s record:

{
  "core": {
    "id": "4eabfc26-3ed9-4ad3-a935-9be07ae3329a",
    "slug": "stripe-south-san-francisco-ca-us",
    "nameBrand": "Stripe",
    "nameLegal": "Stripe, Inc.",
    "nameAlias": [],
    "typeRecord": "Company",
    "operatingStatus": "Operating",
    "image": {
      "logoSquare": "/logos/gfc/gfcNIiXzgUdP6tGupXsKe.png",
      "isMonogram": false
    }
  },
  "urlLink": [
    { "url": "https://stripe.com/", "urlType": "website" },
    { "url": "https://crunchbase.com/organization/stripe", "urlType": "crunchbase" },
    { "url": "https://github.com/stripe", "urlType": "github" },
    { "url": "https://www.linkedin.com/company/stripe", "urlType": "linkedin" },
    { "url": "https://x.com/stripe", "urlType": "twitter" }
  ],
  "classification": {
    "tag": [
      { "id": 1192, "name": "Platform", "slug": "platform", "isPrimary": false },
      { "id": 934, "name": "SaaS", "slug": "saas", "isPrimary": true }
    ],
    "industry": [
      { "id": 245, "name": "Financial Technology Companies", "slug": "financial-technology-companies", "isPrimary": true },
      { "id": 356, "name": "Payment Service Providers", "slug": "payment-service-providers", "isPrimary": false }
    ],
    "mainProduct": [
      { "id": 1385, "name": "Financial", "slug": "financial", "isPrimary": false },
      { "id": 62, "name": "Payments", "slug": "payments", "isPrimary": true }
    ]
  },
  "publicUrl": "https://aventure.vc/companies/stripe-south-san-francisco-ca-us"
}

Fields without a value are left out of the response, so check for a field before reading it. Only current links and categories are returned; past ones are dropped.

Errors

Errors use the problem detail body described in Errors.

Pricing and Usage

Each distinct company you look up counts as one brand view per calendar month (UTC). Looking up the same company again that month is free, whichever identifier you use.

On AI Plus and AI Pro with additional usage turned on, each brand view past the included amount costs $0.001. Without additional usage, a lookup past the included amount answers 429 until the allowance resets. The allowance.entityBrand field of GET /v1/billing/subscription shows how many brand views you have used this month. Plans and usage covers every allowance and how to upgrade.

Pick the Right Read