Company

Company overview

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.

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

Path parameters

handlestring required

Company X handle (with or without @).

Query parameters

includestring
Example:resources

Comma-separated sections to bundle into this one call: resources, founders, funding. Folds what used to be four separately priced calls into one round trip. Each section is priced at its standalone rate (resources 60, founders 100, funding 60); bundling is a latency win, not a discount. The zero-cost-on-empty rules are preserved: founders cost 0 credits when none are found, funding costs 0 when nothing resolves. cost_breakdown_credits shows the per-section charge and everything is deducted in one atomic charge. include=founders uses the fast cached founder join (same as /search?include_founders=true) and does NOT perform the blocking live discovery that GET /company/{handle}/founders does, so a cold company returns resolution_status "resolving" in that section. An unknown section returns 400 with error_code invalid_include.

max_creditsinteger

Ceiling on what this single call may cost, in credits. FAILS CLOSED: checked against the worst case for the sections you requested, before the first upstream call, so an over-budget request computes nothing and charges nothing (400, error_code max_credits_exceeded). Sections that come back empty are still free, so the actual charge is often below the ceiling.

Response

Company overview.

cost_creditsinteger

Credits charged for this call.

balance_creditsinteger

Remaining credit balance after this call.

includedstring[]

Sections bundled into this response. Present only when include was used.

cost_breakdown_creditsobject

Credits charged per section. Sections that returned nothing show 0.

max_cost_creditsinteger

The most this call could have cost with the sections requested.

resourcesobject

Same shape as GET /company/{handle}/resources. Present only with include=resources.

foundersobject

Same shape as GET /company/{handle}/founders. Present only with include=founders.

fundingobject

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.

Changes

No recorded changes to this operation across all 2 revisions of this API.