Developer API Guide

Integrate Onlyus AI search capabilities directly into your applications.

Overview

The Onlyus AI API allows you to access product data and perform advanced hybrid searches (Vector + Keyword) programmatically. The base URL for all requests is http://search.onlyus.co.kr:None.

POST /api/search/text

Search for products using natural language text. Supports automatic translation and smart keyword matching.

Parameters (Form Data)

Field	Type	Description
query	string	Search text (e.g., "Summer dress")
limit	integer	Max results (default: 10)

Example Request (cURL)

curl -X POST "http://search.onlyus.co.kr/api/search/text" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "query=Summer dress" \
  -d "limit=5"

Example Response

[
  {
    "id": 123,
    "name": "Summer Floral Dress",
    "image_url": "/static/images/...",
    "similarity_score": 0.89
  }
]

POST /api/search/image

Search for products visually similar to an uploaded image.

Parameters (Multipart Form Data)

Field	Type	Description
image	file	Image file to search with (JPG/PNG)
limit	integer	Max results (default: 10)

Example Request (cURL)

curl -X POST "http://search.onlyus.co.kr/api/search/image" \
  -H "Content-Type: multipart/form-data" \
  -F "image=@/path/to/image.jpg" \
  -F "limit=5"