Recent Search
Recent Search API는 사용자의 최근 검색 태그 목록을 불러옵니다. 해당 API를 통해 사용자들이 보다 빠른 검색을 할 수 있도록 하세요. 기본으로 최근 검색 태그 값 12개가 제공됩니다.
Request URL
GET
https://messenger.stipop.io/v1/search/recent
Best Practices
- userId 파라미터에 다양한 사용자에 대해 같은 userId 값을 사용하지마세요. 해당 값은 지속적으로 모니터링이 되며 중복값이 사용 될 경우 API key가 비활성화 될 수 있습니다. userId 값은 아무 string 형태의 값이면 됩니다.
- 검색과 연관된 다음 API endpoint도 사용해보세요: Sticker Search, Trending Search Terms. 스티커 검색 최적화 가이드에서 더 상세한 내용도 확인 할 수 있습니다.
Parameters
| Required | Type | Description |
|---|---|---|
| apikey | string | 발급받은 API 키 값: 스티팝 대시보드에서 새로운 API 키를 발급받을 수 있습니다. |
| Required | Type | Description |
|---|---|---|
| userId | string | 앱 사용자에게 부여되는 고유 값. userId는 아무 string 값이면 됩니다. 중요: 여러 사용자에게 동일한 userId를 사용하면 안됩니다. |
Example Request
샘플 요청: 최근 검색
cURL
1
curl --location --request GET "https://messenger.stipop.io/v1/search/recent?userId=xxx" --header "apikey:xxxxxxxxx"Success Response
성공 응답: 200
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"header": {
"code": "0000",
"status": "success",
"message": "success"
},
"body": {
"keywordList": [
{
"keyword": "cute"
},
{
"keyword": "bath"
},
{
"keyword": "hi"
}
]
}
}
Response Format
| Name | Type | Description |
|---|---|---|
| keyword | string | 최근 검색 태그 |
Error Response
| Error | Code | Description |
|---|---|---|
| non exist apikey | 9000 | 사용된 API 키가 존재하지 않습니다. |
| server error | 1000 | 서버에서 정보를 받을 수 없습니다. |
이 페이지가 도움이 되셨나요?
도움이 필요하신가요? 문의주세요.
Back