Charter Boats API
AI Integrations

Search Content (AI)

Search sailing articles, guides, and FAQ answers from the knowledge base

GET/ai/content

Full-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

ParameterTypeRequiredDescription
qstringYesSearch query (minimum 2 characters). Examples: "sailing license greece", "what to pack", "best time to charter croatia".
typestringNoContent type filter: article, question, or both (default: both)
limitintegerNoMax 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=chartering+costs&type=question"

Response

{
  "articles": [
    {
      "title": "Do You Need a Sailing License to Charter in Greece?",
      "summary": "Greece requires an ICC or national sailing license for bareboat charters. Skippered charters have no license requirement.",
      "keywords": ["sailing license", "greece", "ICC", "bareboat"],
      "cover_image": "https://...",
      "url": "https://charter.boats/sailing-license-greece"
    }
  ],
  "questions": [
    {
      "question": "What sailing license do I need for Greece?",
      "answer_summary": "For bareboat charter in Greece, you need an International Certificate of Competence (ICC) or an equivalent national license. No license is needed for skippered charters.",
      "topics": ["licensing", "greece"],
      "url": "https://charter.boats/answers/sailing-license-greece"
    }
  ]
}

Response Fields

FieldTypeDescription
articlesarrayMatching long-form articles (omitted when type=question)
articles[].titlestringArticle title
articles[].summarystring|nullBrief summary or meta description
articles[].keywordsarrayArticle keywords
articles[].cover_imagestring|nullCover image URL
articles[].urlstringLink to article on charter.boats
questionsarrayMatching FAQ entries (omitted when type=article)
questions[].questionstringThe question
questions[].answer_summarystring|nullConcise answer summary. AI clients can use this to answer directly without requiring the user to click through.
questions[].topicsarrayTopic tags
questions[].urlstringLink to full answer on charter.boats

Search Behavior

  • Uses PostgreSQL full-text search with English language configuration
  • For questions, falls back to ILIKE matching on question text and meta description when full-text search returns no results
  • Search terms under 2 characters are filtered out

Errors

StatusMessage
400Search query must be at least 2 characters
400Search query must contain words of at least 2 characters

On this page