# Search published help articles

> GET /docs/search: Search published help articles

`GET https://usedocs.app/docs/search`

Public search over the bot's published help-center articles.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `botId` | query | `string (uuid)` | Yes |  |
| `botKey` | query | `string` |  |  |
| `q` | query | `string` | Yes |  |
| `locale` | query | `string` |  |  |

## Responses

| Status | Description |
| --- | --- |
| `200` | Matching articles |
| `400` | Structured JSON error |
| `403` | Structured JSON error |

## Response fields

| Field | Type | Description |
| --- | --- | --- |
| `query` | `string` |  |
| `articles` | `object[]` |  |