Search Content (AI)

GET/ai/content

Semantic (vector) search across the charter.boats knowledge base. Covers topics like sailing licenses, chartering costs, packing lists, weather, navigation, and destination guides. Returns the most relevant text from both long-form articles and FAQ-style Q&A entries, so AI clients can answer directly.

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

# Search for sailing license information
curl "https://charter.boats/api/ai/content?q=sailing+license+greece"
 
# Only FAQ answers
curl "https://charter.boats/api/ai/content?q=security+deposit&type=question"

Response

{
  "articles": [
    {
      "url": "https://charter.boats/sailing-lefkas-southern-ionian-complete-guide",
      "copy": "Complete Guide to Sailing Lefkas and the Southern Ionian Islands\n\nEverything you need to know about chartering a yacht from Lefkas Marina and exploring the stunning Southern Ionian Islands of Greece..."
    }
  ],
  "questions": [
    {
      "url": "https://charter.boats/answers/security-deposit-charter-boats",
      "copy": "What is the security deposit and when do I pay it?\n\nThe security deposit varies by boat (typically €1,000-€5,000). It is held at check-in and returned after check-out if there is no damage..."
    }
  ]
}

The articles key is present only when type is article or both; the questions key only when type is question or both. Each entry returns the single best-matching chunk of text as copy (up to 2000 characters) plus its url.

Response Fields

Field	Type	Description
`articles`	array	Matching long-form articles (present when `type` is `article` or `both`)
`articles[].url`	string	Link to the article on charter.boats
`articles[].copy`	string	Best-matching passage from the article (up to 2000 chars)
`questions`	array	Matching FAQ entries (present when `type` is `question` or `both`)
`questions[].url`	string	Link to the full answer on charter.boats
`questions[].copy`	string	Best-matching passage from the answer (up to 2000 chars)

Search Behavior

Uses semantic vector search (embeddings) against indexed content chunks, then returns the best-scoring chunk per published article/answer.
Results are ranked by relevance; only published content is returned.
If the embedding/search backend is unavailable, the endpoint degrades gracefully and returns empty articles/questions arrays rather than an error.

Errors

Status	Message
`400`	Search query must be at least 2 characters