Search the Trooth Network

Full-text search over published company listings. Returns the same companies the public directory shows. Prefer cursor pagination: pass the returned next_cursor back as cursor. Offset pagination still works and is kept for clients that already ship with it, but it is deprecated: it counts rows rather than naming a position, so a directory that grows between two requests can serve the same company twice and skip another without erroring. A response to an offset-paged request carries a Deprecation header and a Link header with rel="deprecation"; no withdrawal date is set, so no Sunset header is sent. A cursor that cannot be read returns 400 rather than an empty page. Cached at the edge for 60 seconds with a 300 second stale-while-revalidate window. BEST-EFFORT, MUTABLE ENUMERATION: there is no snapshot. Every page reads the live directory, and the cursor names a position in the sort order, not a point in time; it is not bound to a snapshot, an as-of time or an expiry. A company whose witnessed state changes between two pages can be missed or returned twice, so a walk is not a consistent full export. Drop repeats by slug and walk again to reconcile. The fact pages of /api/network/profile are a different mechanism: their cursor is bound to one record version. 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/mobile/directory/search

Request

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

Query parameters

qstring

Search terms. Matched against company name and description.

industrystring

Restrict to one industry.

limitinteger

Results per page. Clamped to 100; anything unreadable falls back to 25.

cursorstring

Opaque page marker. Use next_cursor from the previous response. Preferred over offset. It names a position in a live list, not a snapshot: it carries no as-of time and no expiry.

offsetinteger

Zero-based offset. Use next_offset from the previous response. Deprecated in favor of cursor; still answered, with a Deprecation header on the response.

Response

A page of results.

totalinteger required
next_offsetinteger nullable required
next_cursorstring nullable required
errorstring

Changes

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