List companies

Returns a paginated list of companies, ranked by news coverage (most-covered first), then name. Filter by entity slug (e.g., 'apple'), ticker, domain, CIK, or QID. Search by name or fetch updates since a timestamp. With no search or filter, the list contains only companies with news coverage; a filter returns every matching company, with uncovered ones last. A bulk ids lookup is not ranked: it returns companies in request order, unpaginated.

get/v1/companies

Request

Base URL: https://api.particle.pro
URL: https://api.particle.pro/v1/companies
Auth: one of:
- API key in header X-API-Key
- HTTP bearer

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

qstring

Search by name (case-insensitive partial match)

Example:Apple

updated_afterstring

Only items updated after this ISO 8601 date or date-time (e.g. 2024-01-01 or 2024-01-01T00:00:00Z). Useful for incremental syncing.

Example:2024-01-01T00:00:00Z

idsstring[] nullable

Bulk multi-get: one or more company slugs (e.g. 'apple'), domains (e.g. 'apple.com'), or IDs, comma-separated (max 100) — the same identifiers GET /v1/companies/{id} accepts. When set, returns exactly those companies and the other filters/search and pagination are ignored. Refs that don't resolve are omitted from the response.

[
  "apple",
  "tesla.com",
  "nvidia"
]

tickerstring[] nullable

Filter by stock ticker symbol(s), comma-separated

[
  "AAPL",
  "GOOG"
]

domainstring[] nullable

Filter by company domain(s), comma-separated

[
  "apple.com"
]

cikstring[] nullable

Filter by SEC CIK(s), comma-separated

[
  "0000320193"
]

qidstring[] nullable

Filter by Wikidata QID(s), comma-separated

[
  "Q312"
]

entity_idstring[] nullable

Entity slug(s) (e.g., 'apple', 'nvidia') or ID(s), comma-separated

Response

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

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