v2.ads.get_recommended_keyword_list
GET /api/v2/ads/get_recommended_keyword_list
Use this API to get the list of Recommended keywords by item and optionally a search keyword
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/ads/get_recommended_keyword_list
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho cửa hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| item_id | int32 | True | 1111 | Shopee's unique identifier for an item. |
| input_keyword | string | False | keyword | The keyword seller typed in the manually add keyword window. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Mã lỗi, để trống khi không có lỗi | |
| message | string | Mô tả lỗi | |
| warning | string | Nếu một số dữ liệu không thể phản hồi bình thường, đặt cảnh báo | |
| request_id | string | 6f235f4a343e4feb8a9ed74c439f6663 | request id là duy nhất cho mỗi yêu cầu |
| response | object | Nội dung phản hồi | |
| item_id | int32 | 1111 | Shopee's unique identifier for an item. |
| input_keyword | string | keyword | The keyword seller typed in the manually add keyword window. |
| suggested_keywords | object[] | Suggested keywords recommended from product. | |
| keyword | string | keyword | Keyword value (Only return the highly recommended keywords, will be sightly different from Seller Center) |
| quality_score | int32 | 8 | This is a measure of how attractive your ad is and its relevance to the keyword. The higher the quality score, the higher your ad rank. Ad rank is based on this score and your bid price. |
| search_volume | int32 | 1234 | The number of times the keyword has been searched on Shopee in the last 30 days. The larger the search volume, the more impressions your ad will receive. |
| suggested_bid | float | 12.34 | This is bid price suggested by Shopee algorithm for the keyword in local currency. |