Search & Intent API

Catalog Search

GET /api/catalog/search?q=image+generation&limit=10

Full-text search across the entire catalog.

Query Parameters

Parameter	Type	Description
q	string	Search query (required)
limit	number	Max results (default: 20)

---

Intent Search

GET /api/services/search/intent?q=I need an API to translate documents

Natural language search that extracts intent, tokenizes the query (supports Japanese), and ranks services by relevance.

Query Parameters

Parameter	Type	Description
q	string	Natural language query (required)

Response

{
  "query": "I need an API to translate documents",
  "tokens": ["translate", "documents"],
  "results": [
    {
      "service": { ... },
      "score": 0.85,
      "matchedTokens": ["translate"],
      "reason": "High relevance to translation services"
    }
  ]
}

Intent Search vs Catalog Search

Feature	Catalog Search	Intent Search
Input	Keywords	Natural language
Tokenization	Simple split	NLP + Japanese particle removal
Ranking	Text match	Semantic relevance scoring
Use case	Structured queries	Agent conversations