Stipop Docs | Documentation for SDK and API

Trending Search Terms

Trending Search Terms API를 사용해 사용자들이 많이 검색한 추천 검색 키워드를 받아보세요. 스티커 검색 API와 함께 사용하면 좋습니다. 기본 값으로 20개의 추천 검색어가 제공됩니다.

Request URL

GET
https://messenger.stipop.io/v1/search/keyword

Best Practices

  1. 권장: 최적의 서비스를 위해 언어(lang)와 국가(countryCode) 파라미터를 사용해 사용자 위치 정보를 제공하세요. 스티팝은 사용자의 선호 언어, 문화, 그리고 로컬 트렌드를 적용해 자동으로 최적화된 스티커를 제공합니다. 언어와 국가의 기본값은 각각 enUS 입니다.
  2. limit 파라미터를 사용해 추천 검색어 로딩 속도를 최적화하세요. 예를 들어 limit을 '30'으로 설정해 30개의 추천 검색어를 불러오세요.
  3. 검색과 연관된 다음 API endpoint도 사용해보세요: Sticker Search, Recent Search. 스티커 검색 최적화 가이드에서 더 상세한 내용도 확인 할 수 있습니다.

Parameters

Request Headers
RequiredTypeDescription
apikeystring발급받은 API 키 값:
스티팝 대시보드에서 새로운 API 키를 발급받을 수 있습니다.
Request Query Parameters
Strongly RecommendedTypeDescription
langstring언어 최적화를 위해 언어 정보를 입력해주세요.
ISO 639-1의 2-letter 언어 코드를 사용하세요.
기본 값: en
countryCodestring국가 최적화를 위해 국가 정보를 입력해주세요.
ISO 3166-1의 2-letter 국가 코드를 사용하세요.
기본 값: US
OptionalTypeDescription
limitint페이지 당 보여줄 스티커 수 제한.
pageNumber를 사용해 스티커 뷰를 최적화하세요.
기본 값: 20 (최대: 50)

Example Request

샘플 요청: 추천 검색 리스트
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

Attributes
NameTypeDescription
keywordstring검색 태그

Error Response

ErrorCodeDescription
non exist apikey9000사용된 API 키가 존재하지 않습니다.
server error1000서버에서 정보를 받을 수 없습니다.
도움이 필요하신가요? 문의주세요.