---
title: "Search every registered provider and return one merged, ranked result list"
method: GET
path: "/api/rest/v1/global-search"
tags: ["Global Search"]
---

# Search every registered provider and return one merged, ranked result list

`GET /api/rest/v1/global-search`

## Request

- Base URL: `https://app.componecat.ai`
- URL: `https://app.componecat.ai/api/rest/v1/global-search`
- Auth: none required

## Query parameters

- `q` string, required
- `kinds` string[]
- `limit` union
  - integer
  - string, int32

## Response `200`

OK

- GlobalSearchResponseResource
  - `results` GlobalSearchResultResource[], required
    - `kind` string, required
    - `id` string, required
    - `title` string, required
    - `group` string, nullable, required
    - `subtitle` string, nullable, required
    - `excerpt` string, nullable, required
    - `path` string, nullable, required
    - `score` union, required
      - number, double
      - string, double
    - `data` GlobalSearchResultDatumResource[], nullable, required
      - `key` string, required
      - `value` string, required
  - `totalCount` union, required
    - integer
    - string, int32

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/componecat/apis/componecat-rest-api.md) · [All operations](https://skmtc.dev/componecat/apis/componecat-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/componecat/apis/componecat-rest-api/revisions/6c53d4984720?raw)