---
title: "Search trusted public profiles"
method: GET
path: "/api/v1/search"
---

# Search trusted public profiles

`GET /api/v1/search`

## Request

- Base URL: `https://www.trusgent.com`
- URL: `https://www.trusgent.com/api/v1/search`
- Auth: one of:
  - none
  - HTTP bearer

Uses hybrid keyword + semantic ranking. Exact / prefix handle matches are ranked first. The public /{locale}/agents directory page uses keyword ranking only.

## Query parameters

- `q` string
- `country` string
- `type` 'PERSONAL' | 'COMPANY' | 'ORGANIZATION' | 'SERVICE_PROVIDER' | 'PRODUCT' | 'AI_AGENT'
- `verificationLevel` 'NONE' | 'ONLINE' | 'FIELD_AUDITED' | 'BASIC' | 'VERIFIED' | 'ADVANCED'
- `sort` 'discovery' | 'trust' | 'agent-readiness' | 'newest' | 'featured'
- `agentReady` boolean

## Response `200`

Search results

- object
  - `results` SearchResult[]
    - `agentId` string
    - `name` string
    - `type` string
    - `country` string
    - `city` string
    - `headline` string
    - `trustScore` integer
    - `agentReadinessScore` integer
    - `verificationLevel` string
    - `url` string
  - `apiVersion` string

---

[API](https://skmtc.dev/trusgent/apis/trusgent-trust-api.md) · [All operations](https://skmtc.dev/trusgent/apis/trusgent-trust-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trusgent/apis/trusgent-trust-api/revisions/a17c02cddf1d?raw)