Docs

API Reference

Read-only JSON over HTTPS. Every endpoint takes a Bearer API key and shares the same limits and error format.

Basics

Base URL: https://tryalphascout.com. Everything lives under /api/v1.
Lists return { total, items } and take limit and offset; offset + limit may not pass 10,000. Use since or filters to go deeper, or the CSV export.
Timestamps are ISO 8601 in UTC. Country codes are ISO 3166 alpha-2.
The machine-readable spec is openapi.json.

Hidden Gems

GET /api/v1/gems

Ranked hidden gems: new launches nobody has backed yet, best first. Use this first when the user wants promising early companies. Every item has a gem score (0-100), labels, and the reasons behind the score with links to the evidence. Only new, un-backed launches qualify. Filter by sector, country or region, and use `since` to get only companies first seen after a date.

Parameter	Description
label	A gem label, e.g. just_launched, developer_traction, verified_revenue, early_raise, under_the_radar.
q	Text search over name, website and description.
sector	Exact sector name as AlphaScout labels it, e.g. Fintech.
country	ISO 3166 alpha-2 country code, e.g. DE or IN.
region	A world region. One of `europe`, `north_america`, `latam`, `africa`, `mena`, `south_asia`, `southeast_asia`, `east_asia`, `oceania`.
backer	Only companies backed by this accelerator or fund, e.g. YC or Antler.
business_model	Business model, e.g. saas, marketplace, api.
min_score	Minimum gem score, 0 to 100.
first_seen_days	Only companies first seen in the last N days.
since	Only companies first seen after this moment (ISO 8601 date or time). Use it to fetch just what is new.
limit	Page size, up to 100. Default 50.
offset	Skip this many results.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/gems?sector=Fintech&limit=5"

Companies

GET /api/v1/companies

Every tracked early company, filtered and sorted. Broader than hidden gems: all early companies AlphaScout tracks, including those without a gem score. Use it to look a company up by name or website (`q`), or to list companies that have evidence from several independent signal families (`min_families`).

Parameter	Description
q	Text search over name, website and description.
sector	Exact sector name as AlphaScout labels it, e.g. Fintech.
country	ISO 3166 alpha-2 country code, e.g. DE or IN.
region	A world region. One of `europe`, `north_america`, `latam`, `africa`, `mena`, `south_asia`, `southeast_asia`, `east_asia`, `oceania`.
backer	Only companies backed by this accelerator or fund, e.g. YC or Antler.
family	Only companies with a signal of this family, e.g. launch, developer, funding, hiring, press, registry, grant.
source	Only companies seen by this source key.
min_families	Minimum number of independent signal families.
min_score	Minimum emergence score, 0 to 100.
first_seen_days	Only companies first seen in the last N days.
since	Only companies first seen after this moment (ISO 8601 date or time). Use it to fetch just what is new.
sort	Sort order. One of `score`, `recent`, `first_seen`, `sources`, `signals`, `gem`.
limit	Page size, up to 100. Default 50.
offset	Skip this many results.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/companies?sector=Fintech&limit=5"

Company Profile

GET /api/v1/companies/{id}

One company's full profile with its evidence and funding. Returns the profile, every signal (each with its source link), identifiers and funding history for one company. Get the id from search_companies or list_hidden_gems.

Parameter	Description
id (path)	The company's AlphaScout id.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/companies/1234"

Similar Companies

GET /api/v1/companies/{id}/similar

Comparable companies, with the reasons each one matches. Finds companies that resemble one you already have, and says why (sector, business model, customers, market or a product that reads alike).

Parameter	Description
id (path)	The company's AlphaScout id.
limit	How many comparables, up to 20.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/companies/1234/similar"

Latest Releases

GET /api/v1/releases

What companies just shipped, one entry per company. New products, directory listings, AI models, MCP servers and open-source repositories from the last days. Use `kind` to narrow it.

Parameter	Description
kind	Kind of release. One of `all`, `product`, `directory`, `model`, `mcp`, `repo`.
days	Look back this many days, 1 to 90.
country	ISO 3166 alpha-2 country code, e.g. DE or IN.
region	A world region. One of `europe`, `north_america`, `latam`, `africa`, `mena`, `south_asia`, `southeast_asia`, `east_asia`, `oceania`.
q	Text search over name, website and description.
since	Only releases after this moment (ISO 8601).
limit	Page size, up to 100. Default 40.
offset	Skip this many results.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/releases?country=DE&limit=5"

Signals

GET /api/v1/signals

Raw evidence, newest first. The raw feed behind the rankings: launches, filings, hires, accelerator batches, grants and press, each linked to the company it belongs to and to where it was published.

Parameter	Description
company_id	Only signals of this company.
family	Signal family, e.g. launch or funding.
signal_type	Signal type, e.g. product_launch, funding_filing.
q	Text search over name, website and description.
source	Source key.
limit	Page size, up to 200. Default 50.
offset	Skip this many results.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/signals?limit=5"

Scoring Rules

GET /api/v1/scoring

The scoring rules exactly as the engine applies them. The published weights per signal type and the gem adjustments. Use it to explain why a company scored as it did.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/scoring"

CSV Export

GET /api/v1/export?page=gems

Up to 10,000 rows as CSV. page is gems, companies or releases, and the filters of the matching list endpoint apply. 20 exports an hour per key.

Example

curl -H "Authorization: Bearer as_live_…" \
  "https://tryalphascout.com/api/v1/export?page=gems&sector=Fintech" -o gems.csv

Health

GET /api/v1/health

No key needed. 200 when the site and the engine answer, 503 when the engine doesn't.