---
title: "Company overview"
method: GET
path: "/company/{handle}"
tags: ["Company"]
---

# Company overview

`GET /company/{handle}`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/company/{handle}`
- Auth: API key in header `X-API-Key`

Synthesized company overview: profile data, sector classification, entity type, a live website scrape summary, and recent posts. Works for any public X handle, not just companies already in your database (the profile is fetched live). Costs 60 credits. This is the standard first deep-dive after /trending, /convergence, or /search/thesis surfaces a candidate; follow with /company/{handle}/founders and /company/{handle}/funding.

## Path parameters

- `handle` string, required

## Query parameters

- `include` string
- `max_credits` integer

## Response `200`

Company overview.

- object
  - `company` object
    - `handle` string
    - `name` string
    - `bio` string
    - `website` string, nullable
    - `profile_image` string
    - `followers` integer
    - `following` integer
    - `created_at` string
    - `sector` string
    - `entity_type` string
    - `is_company` boolean, nullable
    - `confidence` string
    - `about` string
    - `website_summary` string, nullable
    - `recent_activity` object[]
      - `text` string
      - `date` string
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.
  - `included` string[]: Sections bundled into this response. Present only when include was used.
  - `cost_breakdown_credits` object: Credits charged per section. Sections that returned nothing show 0.
  - `max_cost_credits` integer: The most this call could have cost with the sections requested.
  - `resources` object: Same shape as GET /company/{handle}/resources. Present only with include=resources.
  - `founders` object: Same shape as GET /company/{handle}/founders. Present only with include=founders.
  - `funding` object: Same schema as GET /company/{handle}/funding, so one parser works either way. Its nested cost_credits is THIS section's cost; the top-level cost_credits is the whole call. Present only with include=funding.

## Other responses

- `400`: Unknown include section, or max_credits exceeded.
- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)