AI Integrations
Search Content (AI)
Search sailing articles, guides, and FAQ answers from the knowledge base
GET
/ai/contentFull-text search across the charter.boats knowledge base. Covers topics like sailing licenses, chartering costs, packing lists, weather, navigation, and destination guides. Returns both long-form articles and FAQ-style Q&A entries.
Authentication
No authentication required. Rate limited to 60 requests per 10 minutes.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query (minimum 2 characters). Examples: "sailing license greece", "what to pack", "best time to charter croatia". |
type | string | No | Content type filter: article, question, or both (default: both) |
limit | integer | No | Max results per type (default: 5, max: 20) |
Request
Response
Response Fields
| Field | Type | Description |
|---|---|---|
articles | array | Matching long-form articles (omitted when type=question) |
articles[].title | string | Article title |
articles[].summary | string|null | Brief summary or meta description |
articles[].keywords | array | Article keywords |
articles[].cover_image | string|null | Cover image URL |
articles[].url | string | Link to article on charter.boats |
questions | array | Matching FAQ entries (omitted when type=article) |
questions[].question | string | The question |
questions[].answer_summary | string|null | Concise answer summary. AI clients can use this to answer directly without requiring the user to click through. |
questions[].topics | array | Topic tags |
questions[].url | string | Link to full answer on charter.boats |
Search Behavior
- Uses PostgreSQL full-text search with English language configuration
- For questions, falls back to
ILIKEmatching on question text and meta description when full-text search returns no results - Search terms under 2 characters are filtered out
Errors
| Status | Message |
|---|---|
400 | Search query must be at least 2 characters |
400 | Search query must contain words of at least 2 characters |