# List search profiles

**Publié le** : 2026-05-08
**Catégorie** : Core CMS

## `GET /search/profiles`

**List search profiles**

Returns the search profiles configured for the site. Profiles let an
admin define multiple scoped search experiences (e.g. one per
documentation space) with their own searchable/displayed fields, sort
and facets, all sharing a single underlying search index.

Required permissions: `search.profiles.view`

### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |


> **Notes:** - The public variant (`/public/:siteId/search/profiles`) only returns
>   profiles flagged `isPublic = true` and never exposes the internal
>   scope filter, searchable subset, boosted IDs, etc.
> 
> - The V1 variant (`/v1/search/profiles`) requires an API token with
> `search.profiles.view` and returns the full profile bodies.

### Examples

```bash
curl "https://api.lynkow.com/v1/search/profiles" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "X-Site-Id: $SITE_ID"
```

### Response Example

```json
{
  "data": [
    {
      "slug": "default",
      "name": "Default",
      "description": "Default search profile covering all indexed content.",
      "facets": [],
      "defaultLimit": 20,
      "maxLimit": 100
    },
    {
      "slug": "api-docs",
      "name": "API Docs",
      "description": "Search scoped to the API reference.",
      "facets": [
        "categories.slug",
        "tags.slug"
      ],
      "defaultLimit": 20,
      "maxLimit": 50
    }
  ]
}
```

---