Skip to main content

Quickstart

Use this flow to make your first Truee search request.

1. Create an AI company account​

Open the AI Portal and create or select your AI company account:

https://usetruee.com/dashboard/ai-portal

2. Copy your API key​

Use the API key from the AI Portal. Send it with every private Search API or MCP request:

x-api-key: YOUR_TRUEE_API_KEY

3. Search businesses​

Natural language search is best when the user gives plain text.

curl -X POST https://api.usetruee.com/api/v1/registry/search \
  -H "content-type: application/json" \
  -H "x-api-key: $TRUEE_API_KEY" \
  -d '{
    "q": "fintech companies in Nigeria",
    "country": "NG",
    "limit": 10
  }'

4. Fetch a full profile​

Search results include an id, slug, profile_url, and data_url. Use the id or slug to fetch a full profile:

curl https://api.usetruee.com/api/v1/registry/businesses/paysnug-technology-limited \
  -H "x-api-key: $TRUEE_API_KEY"

5. Use structured search for agents​

If your app already parsed the query, use the cheaper structured endpoint:

curl "https://api.usetruee.com/api/v1/registry/query?keywords=fintech&country=NG&limit=10" \
  -H "x-api-key: $TRUEE_API_KEY"