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.
Request
- Base URL: https://trooth.co
- URL: https://trooth.co/api/network/search
- Auth: none required
Query parameters
Free text, matched against name, tagline, domain, industries and product names.
An industry, matched as a substring of the company's industries.
The HQ country, as the company published it; exact, case-insensitive.
A data residency region, as companies write it (EU, US, UK...); exact, case-insensitive.
A deployment model (Cloud, Private cloud / VPC, On-prem, Hybrid); exact, case-insensitive.
A product name, matched as a substring of the visible offering section.
true for companies with a witnessed reading, false for those without.
Only companies whose profile changed at or after this ISO 8601 date or UTC time.
Results per page, 1 to 100 (default 25).
next_cursor from the previous page, sent with the same filters.
Response
A page of matching companies.
Changes
No recorded changes to this operation across all 1 revision of this API.