메인 콘텐츠로 건너뛰기
POST
/
search
Search IP Assets
curl --request POST \
  --url https://api.storyapis.com/api/v4/search \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "query": "<string>",
  "pagination": {
    "limit": 20,
    "offset": 0
  }
}
'
{
  "data": [
    {
      "description": "<string>",
      "ipId": "<string>",
      "mediaType": "<string>",
      "score": 123,
      "similarity": 123,
      "title": "<string>"
    }
  ],
  "total": 123,
  "$schema": "<string>",
  "pagination": {
    "hasMore": true,
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}
검색은 IPA 메타데이터 표준을 사용하여 IP 메타데이터의 제목과 설명을 벡터화하여 수행됩니다.

인증

X-Api-Key
string
header
필수

본문

application/json
query
string
필수

The search query string

Required string length: 1 - 1000
예시:

"dragon NFT"

mediaType
enum<string>

Optional media type filter - must be 'audio', 'video', or 'image'. Leave empty to search all media types

사용 가능한 옵션:
audio,
video,
image
예시:

"image"

pagination
object

Pagination configuration

응답

OK

data
object[] | null
필수

List of IP asset search results

total
integer<int64>
필수

Total number of search results found

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

예시:

"https://api.storyapis.com/api/v4/SearchResponseBodyHuma.json"

pagination
object

Pagination information