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>'
{
  "filtered_count": 123,
  "metadata": {},
  "page": 123,
  "per_page": 123,
  "results": [
    {
      "category": "<string>",
      "created_at": 123,
      "description": "<string>",
      "id": "<string>",
      "metadata": {},
      "slug": "<string>",
      "status": 123,
      "subcategory": "<string>",
      "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). Alpha=0.3 significa 30% texto + 70% vetor.

​
threshold_keyword
number

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

​
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)

​
threshold_ai
number

Score mínimo para busca AI com generate_scores=true (0-1, filtra por ai_score.final_score)

​
exclude_agent_exclusive
boolean
default:false

Se true, exclui serviços exclusivos para agentes IA (mostra apenas serviços para humanos)

​
generate_scores
boolean
default:false

Gera scores detalhados via LLM para os resultados (apenas type=ai).

​
recency_boost
boolean
default:false

Aplica boost por recência: docs atualizados nos últimos 30 dias mantêm score, docs mais antigos sofrem decay gradual

Response

OK

​
filtered_count
integer

Após aplicar thresholds

​
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

Total original do Typesense