Skip to main content
GET
/
api
/
v1
/
search
Busca unificada de serviços públicos
curl --request GET \
  --url https://services.pref.rio/app-busca-search/api/v1/search \
  --header 'Authorization: Bearer <token>'
{
  "metadata": {},
  "page": 123,
  "per_page": 123,
  "results": [
    {
      "category": "<string>",
      "created_at": 123,
      "description": "<string>",
      "id": "<string>",
      "metadata": {},
      "status": 123,
      "title": "<string>",
      "updated_at": 123
    }
  ],
  "search_type": "keyword",
  "total_count": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
q
string
required

Texto da busca

​
type
string
required

Tipo de busca: keyword, semantic, hybrid ou ai

​
page
integer
default:1

Número da página (mínimo: 1)

​
per_page
integer
default:10

Resultados por página (máximo: 100)

​
include_inactive
boolean
default:false

Incluir serviços inativos (status != 1)

​
alpha
number
default:0.3

Alpha para busca hybrid (0-1, default: 0.3)

​
threshold_keyword
number

Score mínimo para busca keyword (0-1, filtra text_match normalizado)

​
threshold_semantic
number

Score mínimo para busca semantic (0-1, filtra por similaridade vetorial)

​
threshold_hybrid
number

Score mínimo para busca hybrid (0-1, filtra score híbrido combinado)

​
exclusive_for_agents
boolean
default:false

Se true, retorna apenas serviços marcados como exclusivos para agentes IA

Response

OK

​
metadata
object

Para AI search

​
page
integer
​
per_page
integer
​
results
object[]
​
search_type
enum<string>
Available options:
keyword,
semantic,
hybrid,
ai
​
total_count
integer