Trending Search Terms
Trending Search Terms API를 사용해 사용자들이 많이 검색한 추천 검색 키워드를 받아보세요. 스티커 검색 API와 함께 사용하면 좋습니다. 기본 값으로 20개의 추천 검색어가 제공됩니다.
Request URL
GET
https://messenger.stipop.io/v1/search/keyword
Best Practices
- 권장: 최적의 서비스를 위해 언어(lang)와 국가(countryCode) 파라미터를 사용해 사용자 위치 정보를 제공하세요. 스티팝은 사용자의 선호 언어, 문화, 그리고 로컬 트렌드를 적용해 자동으로 최적화된 스티커를 제공합니다. 언어와 국가의 기본값은 각각 en과 US 입니다.
- limit 파라미터를 사용해 추천 검색어 로딩 속도를 최적화하세요. 예를 들어 limit을 '30'으로 설정해 30개의 추천 검색어를 불러오세요.
- 검색과 연관된 다음 API endpoint도 사용해보세요: Sticker Search, Recent Search. 스티커 검색 최적화 가이드에서 더 상세한 내용도 확인 할 수 있습니다.
Parameters
Required | Type | Description |
---|---|---|
apikey | string | 발급받은 API 키 값: 스티팝 대시보드에서 새로운 API 키를 발급받을 수 있습니다. |
Strongly Recommended | Type | Description |
---|---|---|
lang | string | 언어 최적화를 위해 언어 정보를 입력해주세요. ISO 639-1의 2-letter 언어 코드를 사용하세요. 기본 값: en |
countryCode | string | 국가 최적화를 위해 국가 정보를 입력해주세요. ISO 3166-1의 2-letter 국가 코드를 사용하세요. 기본 값: US |
Optional | Type | Description |
limit | int | 페이지 당 보여줄 스티커 수 제한. pageNumber를 사용해 스티커 뷰를 최적화하세요. 기본 값: 20 (최대: 50) |
Example Request
샘플 요청: 추천 검색 리스트
cURL
1
curl --location --request GET "https://messenger.stipop.io/v1/search/keyword" --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": "hi"
},
{
"keyword": "hello"
},
{
"keyword": "thanks"
}
]
}
}
Response Format
Name | Type | Description |
---|---|---|
keyword | string | 검색 태그 |
Error Response
Error | Code | Description |
---|---|---|
non exist apikey | 9000 | 사용된 API 키가 존재하지 않습니다. |
server error | 1000 | 서버에서 정보를 받을 수 없습니다. |
이 페이지가 도움이 되셨나요?
도움이 필요하신가요? 문의주세요.