Discover companies by several criteria

Multi-criteria discovery over the same published companies the directory lists: free text, industry, HQ country, data residency region, deployment model, product name, whether Trooth holds a witnessed reading, and profile changes since a date. A company is matched only by facts its public page shows: residency and deployment are searchable only while the company shows the section that renders them. Filters are exact, case-insensitive matches on what the company published; a company that published nothing for a filtered field is absent from the answer, which is not a no. Order is the directory's: witnessed first, then the most recent reading, then name; never by a figure. Each result carries facts, whole days counted from timestamps on the record (days_since_last_witnessed, days_since_profile_updated), which rate nothing. Cursor pagination only; a cursor is bound to the filters it was issued with. An unknown filter is refused. Errors are always RFC 9457 problem details (codes at /api/problems). Cached at the edge for 60 seconds with a 300 second stale-while-revalidate window. Readable cross-origin: the response carries Access-Control-Allow-Origin: * and never Access-Control-Allow-Credentials, so a browser on any site may read it without cookies.

get/api/network/search

Request

  • Base URL: https://trooth.co
  • URL: https://trooth.co/api/network/search
  • Auth: none required

Query parameters

qstring

Free text, matched against name, tagline, domain, industries and product names.

industrystring

An industry, matched as a substring of the company's industries.

countrystring

The HQ country, as the company published it; exact, case-insensitive.

residencystring

A data residency region, as companies write it (EU, US, UK...); exact, case-insensitive.

hostingstring

A deployment model (Cloud, Private cloud / VPC, On-prem, Hybrid); exact, case-insensitive.

productstring

A product name, matched as a substring of the visible offering section.

witnessed'true' | 'false'

true for companies with a witnessed reading, false for those without.

updated_sincestring

Only companies whose profile changed at or after this ISO 8601 date or UTC time.

limitinteger

Results per page, 1 to 100 (default 25).

cursorstring

next_cursor from the previous page, sent with the same filters.

Response

A page of matching companies.

format'trooth.network-search.v1' required

Names this shape.

totalinteger required

How many companies match, across all pages, on this read.

next_cursorstring nullable required

Send as cursor, with the same filters, for the next page; null at the end.

orderstring required

The ordering rule, in words.

how_to_readstring required

How to read this answer.

Changes

No recorded changes to this operation across all 1 revision of this API.