Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "고양이 이름, 품종, 기록 내용 또는 태그. facet만 검색할 때 생략 가능"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8,
"description": "종류별 최대 결과 수"
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "The previous nextCursor. Keep query, facets, sort and kind unchanged."
},
"facets": {
"type": "object",
"properties": {
"breed": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "Breed ID or a recorded breed name"
},
"coatColor": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
},
"pose": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
},
"activity": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
},
"scene": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
},
"mood": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "An observed photo attribute (English code or Korean/Japanese term), or a recorded caption/tag term. Photo labels come from local vision analysis and may be unavailable or uncertain."
}
},
"additionalProperties": false
},
"kind": {
"type": "string",
"enum": [
"all",
"posts",
"cats"
],
"default": "all"
},
"sort": {
"type": "string",
"enum": [
"latest",
"popular",
"cute",
"funny"
],
"default": "latest"
},
"catId": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "선택. 프로필에서 이어서 특정 고양이 기록 보기"
},
"fields": {
"type": "array",
"minItems": 1,
"maxItems": 32,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"query",
"facetSource",
"webUrl",
"facets.breed",
"facets.coatColor",
"facets.pose",
"facets.activity",
"facets.scene",
"facets.mood",
"total",
"catTotal",
"postTotal",
"hasMore",
"nextCursor",
"cats.id",
"cats.url",
"cats.webUrl",
"cats.name",
"cats.breed",
"cats.breedId",
"cats.intro",
"cats.avatar",
"cats.imageUrl",
"cats.thumbnail",
"posts.id",
"posts.url",
"posts.webUrl",
"posts.caption",
"posts.tags",
"posts.recordDate",
"posts.image",
"posts.imageUrl",
"posts.thumbnail",
"posts.catId",
"posts.catUrl",
"posts.reactions.likes",
"posts.reactions.cute",
"posts.reactions.funny",
"posts.reactions.total",
"posts.discovery.source",
"posts.discovery.coverage",
"posts.discovery.confidence",
"posts.discovery.observedAt",
"posts.discovery.attributes.breed",
"posts.discovery.attributes.coatColor",
"posts.discovery.attributes.pose",
"posts.discovery.attributes.activity",
"posts.discovery.attributes.scene",
"posts.discovery.attributes.mood"
]
},
"description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다."
}
},
"examples": [
{
"query": "케이짱",
"limit": 5
},
{
"facets": {
"activity": "잠"
},
"kind": "posts"
}
],
"additionalProperties": false
}