Query Businesses

Truee has two search modes: natural language search and structured search.

Natural language search

Use natural language search when the input is a human sentence or an AI-generated phrase.

POST /registry/search

{
  "q": "payment companies in Lagos Nigeria",
  "country": "NG",
  "view": "compact",
  "limit": 10
}

Natural language search extracts intent, category, and location before searching the registry.

Query cost: 2 units.

Use structured search when your app or agent already knows the core fields.

GET /registry/query

Common query parameters:

Parameter	Description
`keywords`	Core search keywords, for example `fintech`.
`intent`	`find_business`, `find_product`, or `find_service`.
`category`	Business category or industry.
`country`	ISO-2 country code or country name.
`state`	State or province.
`city`	City name.
`area`	Neighborhood, market, or district.
`verified_only`	Return only verified businesses.
`limit`	Number of results to return.

Query cost: 1 unit.

View	Use case
`compact`	Fast result lists for agents and search pages.
`standard`	Includes richer highlights, location, and subcategory data.