System Atlas
SystemAtlas

Top organizations

The top organizations by a published figure (revenue, employees, funding, each with its year, page and publisher) or a rankings dimension, within a scope, keyset-paged, with the rankings board's locks. strict=yes keeps reported figures only.

GET/api/v1/topPublic

Authentication

None. Send a key anyway to get the same answer.

Parameters

Query

  • metricenumrequired

    A rankings dimension (0-1 score) or a figure (revenue, employees, funding)

    energyeconomictemporalhumanpowerinformationentropytechnicalscalespatialrevenueemployeesfunding
  • industrystringoptional

    Taxonomy key (sector, industry or segment); includes everything under it

    max 80 chars
  • regionstringoptional

    Region word, e.g. US or Texas

    max 120 chars
  • kindstringoptional

    Organization kind, e.g. company, nonprofit, government

    max 40 chars
  • sizestringoptional

    Size band, e.g. 51-200

    max 40 chars
  • modelstringoptional

    Business model key

    max 40 chars
  • strictenumoptional
    yesno
  • fieldsstringoptional

    Keys to keep per item, comma-separated; aliases values, sources, counts, confidence

    max 300 chars
  • limitnumberoptional

    Items per response, 1-200 (the budget may stop earlier)

    ≥ 1≤ 200
  • cursorstringoptional

    next_cursor from the previous response

    max 2000 chars
  • viewenumoptional

    compact (default), full (every field) or v1 (the old shape, unpaged, refused over 64 KB)

    compactfullv1
  • budgetnumberoptional

    Token budget, 200-8000 (default 2000, 6000 for full)

    ≥ 200≤ 8000
  • formatenumoptional

    Old name of view

    compactfullv1

Request

curl "https://systematlas.org/api/v1/top?metric=revenue&industry=staffing&limit=2"

Response

200 with the result in data (abbreviated here). Errors are listed in Errors and limits.

Response
{
  "data": {
    "metric": "revenue",
    "total": 120,
    "items": [
      {
        "h": "org:randstad-1c2d3e4f",
        "ref": "randstad-1c2d3e4f",
        "name": "Randstad",
        "domain": "randstad.com",
        "industry": "staffing",
        "rank": 1,
        "value": 27000000000,
        "year": 2025,
        "url": "https://www.randstad.com/investors/annual-report-2025",
        "source": "Randstad annual report",
        "mapped": 13
      },
      {
        "h": "org:adecco-5a6b7c8d",
        "ref": "adecco-5a6b7c8d",
        "name": "Adecco",
        "domain": "adecco.com",
        "industry": "staffing",
        "rank": 2,
        "value": 25000000000,
        "year": 2025,
        "mapped": 11
      }
    ],
    "truncated": true,
    "next_cursor": "eyJrIjpb…",
    "hint": "More: call top with cursor=<next_cursor>.",
    "tokens": 150
  }
}

Over MCP

The same call as an MCP tool: top.

PreviousAggregate the registryNext Diff two organizations