# API - Lấy danh sách thông tin khuyến mại theo nhà cung cấp & ngành hàng. ## Lấy danh sách từ khóa chiến dịch hot `GET` `https://api.accesstrade.vn/v1/offers_informations/keyword_list` This endpoint allows you to get free cakes. {% tabs %} {% tab title="200 " %} ```javascript { "data": [ { "icon_text": "ShopeePay", "id": "shopee-181427514064896", "total_offer": 6 }, { "icon_text": "Mã ưu đãi", "id": "shopee-172130319171584", "total_offer": 1 }, { "icon_text": "VISA", "id": "shopee-74256396", "total_offer": 1 } ], "success": true } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | ------------ | --------------------------------------------------- | | icon\_text | Từ khóa | | id | ID từ khóa, dùng trong API lấy danh sách khuyến mại | | total\_offer | Số lượng mã khuyến mại theo từ khóa | ## Lấy danh sách nhà cung cấp khuyến mại `GET` `https://api.accesstrade.vn/v1/offers_informations/merchant_list` {% tabs %} {% tab title="200 " %} ```javascript { "data": [ { "display_name": "Shopee", "id": "4742147753565840242", "login_name": "shopee", "logo": "https://content.accesstrade.vn/adv/1630740753_avatar_1630740753.gif", "total_offer": 7480 }, { "display_name": "tiki vn", "id": "4348611690224153209", "login_name": "tikivn", "logo": "https://content.accesstrade.vn/adv/1630929502_avatar_1630929502.gif", "total_offer": 423 }, { "display_name": "watsons", "id": "5701060131880384103", "login_name": "watsons", "logo": "https://content.accesstrade.vn/adv/1629711522_avatar_1629711522.png", "total_offer": 2 }, { "display_name": "Sendo", "id": "4348611682079477428", "login_name": "sendovn", "logo": "https://content.accesstrade.vn/adv/1631094599_avatar_1631094599.png", "total_offer": 1 } ], "success": true } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | ------------- | -------------------------------------------------------- | | id | ID nhà cung cấp, dùng trong API lấy danh sách khuyến mại | | display\_name | Tên nhà cung cấp | | login\_name | Tên nhà cung cấp (encode) | | logo | Hình đại diện nhà cung cấp | | total\_offer | Số lượng mã khuyến mại theo nhà cung cấp | `GET` `https://api.accesstrade.vn/v1/offers_informations/icontext_list` Lấy danh sách từ khóa nhóm vouchers của nhà cung cấp #### Path Parameters | Name | Type | Description | | ------------------------------------------ | ------ | --------------------------------------------- | | merchant\* | String | ID nhà cung cấp, lấy từ API "/merchant\_list" | {% tabs %} {% tab title="200: OK Lấy dữ liệu thành công" %} ```javascript { // Response } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | ------------ | --------------------------------------- | | icon\_text | Tên từ khóa | | merchant | ID nhà cung cấp | | total\_offer | Số lượng vouchers lấy được theo từ khóa | `GET` `https://api.accesstrade.vn/v1/offers_informations/coupon` Lấy danh sách vouchers theo từ khóa nhà cung cấp #### Path Parameters | Name | Type | Description | | -------------------------------------------- | ------ | -------------------------------------- | | icon\_text\* | String | Từ khóa muốn lấy | | limit | int | Giới hạn số lượng vouchers mỗi lần lấy | | Key | Mô tả | | -------------------- | ------------------------------------------------------------------------------------------------------------------- | | banners | là 1 list chứa các dict banner, trong mỗi dict có: “link” - url banner, “width” - chiều rộng, “height” - chiều cao. | | content | Mô tả khuyến mại | | id | id khuyến mại | | image | url ảnh đại diện khuyến mại | | link | url khuyến mại | | merchant | nhà cung cấp mã khuyến mại | | categories | danh sách category của khuyến mại | | name | Tên khuyến mại | | start\_time | Thời gian bắt đầu khuyến mại | | end\_time | Thời gian kết thúc khuyến mại | | domain | Domain sản phẩm khuyến mại | | prod\_link | Affiliate link | | coupons | Chi tiết mã khuyến mại | | coin\_cap | Số tiền được khuyến mại tối đa | | coin\_percentage | Phần trăm khuyến mại tối đa | | percentage\_used | Phần trăm số lượng khuyến mại đã sử dụng | | discount\_value | Giá trị được giảm | | discount\_percentage | Phần trăm được giảm | ## Lấy danh sách ngành của nhà cung cấp & mã khuyến mại `GET` `https://api.accesstrade.vn/v1/offers_informations/list_category_coupons` {% tabs %} {% tab title="200 " %} ```javascript { "data": [ { "category": [ { "category_name": "EC-29", "category_name_show": "Other", "category_no": "" } ], "count": 7903, "type": "E-COMMERCE" }, { "category": [ { "category_name": "BE-44", "category_name_show": "Beauty - Salon", "category_no": "" } ], "count": 2, "type": "BEAUTY" } ], "success": true } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | --------------------------- | ---------------------------- | | category\_name | Mã ngành (nhóm khuyến mãi) | | category\_*name\_*show | Tên ngành (nhóm khuyến mãi) | ## Lấy danh sách mã khuyến mại `GET` `https://api.accesstrade.vn/v1/offers_informations/coupon` #### Path Parameters | Name | Type | Description | | --------------------- | ------- | ------------------------------------------------------------------------------------------------- | | is\_next\_day\_coupon | boolean |

True: lấy danh sách khuyến mại sắp diễn ra
False: lấy danh sách khuyến mại đang diễn ra

| | keyword | string | UID từ khóa cần chọn lọc | | merchant | string | UID mã nhà cung cấp cần chọn lọc | | limit | number | Số bản ghi hiển thị trên 1 trang | | page | number | Số trang kết quả | {% tabs %} {% tab title="200 " %} ``` { "data": { "count": 7908, "count_current_day_coupon": 7908, "count_next_day_coupon": 0, "data": [ { "banner": [], "campaign": "322", "campaign_id": "4751584435713464237", "campaign_name": "Shopee Việt Nam Smartlink cho tất cả thiết bị", "categories": [ { "category_name": "EC-29", "category_name_show": "Other", "category_no": "" } ], "coin_cap": 0, "coin_percentage": 0, "content": "Sử dụng mã miễn phí vận chuyển cho đơn hàng bất kì từ 0Đ thỏa điều kiện ưu đãi khi mua hàng trên Shopee:\r\n- Giảm tối đa 20K cho đơn hàng giao đến Hà Nội và Hồ Chí Minh.\r\n- Giảm tối đa 40K cho đơn hàng giao đến các tỉnh/thành phố khác.\r\nChỉ áp dụng cho đơn hàng đầu tiên của khách hàng mới.\r\nÁp dụng khi đặt hàng bằng ứng dụng Shopee.\r\nHình thức thanh toán: Tất cả.\r\nKênh vận chuyển khả dụng: Hỏa Tốc, Nhanh.\r\nMã chỉ được hoàn theo quy định của Shopee.\r\nHạn sử dụng từ 00:00 02/10/2021 - 23:58 02/10/2021.\r\nMã ưu đãi áp dụng với một số sản phẩm thuộc phạm vi chương trình. \r\nSố lượt sử dụng có hạn, chương trình và mã có thể kết thúc khi hết lượt ưu đãi hoặc khi hết hạn ưu đãi, tùy điều kiện nào đến trước.", "coupons": [ { "coupon_code": "FSV-192996067098624", "coupon_desc": "Đơn hàng đầu tiên" } ], "ctime": "Sat, 02 Oct 2021 00:21:04 GMT", "discount_percentage": 0, "discount_value": 0, "end_date": "Sat, 02 Oct 2021 23:58:00 GMT", "id": "shopee-192996067098624", "image": "https://content.accesstrade.vn/adv/1630740753_avatar_1630740753.gif", "is_hot": "False", "link": "https://shopee.vn/search?promotionId=192996067098624&signature=724443419ba6abaca74a7ded5fa99ddf837f858b26421c4ab39f4bc6b18d3d40&voucherCode=FSV-192996067098624&ref=sansandeals", "max_value": 0, "merchant": "shopee", "min_spend": 0, "name": "[SHOPEE]-Đơn hàng đầu tiên", "percentage_used": 31, "prod_link": "https://go.isclix.com/deep_link/4348611760548105593?url=https://shopee.vn/search?promotionId=192996067098624&signature=724443419ba6abaca74a7ded5fa99ddf837f858b26421c4ab39f4bc6b18d3d40&voucherCode=FSV-192996067098624&ref=sansandeals", "register": 1, "shop_id": null, "start_date": "Sat, 02 Oct 2021 00:00:00 GMT", "status": 1, "time_left": "Còn lại 0 ngày 7 giờ 46 phút" } ] }, "success": true } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | -------------------- | ------------------------------------------------------------------------------------------------------------------- | | banners | là 1 list chứa các dict banner, trong mỗi dict có: “link” - url banner, “width” - chiều rộng, “height” - chiều cao. | | content | Mô tả khuyến mại | | id | id khuyến mại | | image | url ảnh đại diện khuyến mại | | link | url khuyến mại | | merchant | nhà cung cấp mã khuyến mại | | categories | danh sách category của khuyến mại | | name | Tên khuyến mại | | start\_time | Thời gian bắt đầu khuyến mại | | end\_time | Thời gian kết thúc khuyến mại | | domain | Domain sản phẩm khuyến mại | | prod\_link | Affiliate link | | coupons | Chi tiết mã khuyến mại | | coin\_cap | Số tiền được khuyến mại tối đa | | coin\_percentage | Phần trăm khuyến mại tối đa | | percentage\_used | Phần trăm số lượng khuyến mại đã sử dụng | | discount\_value | Giá trị được giảm | | discount\_percentage | Phần trăm được giảm | ## Lấy danh sách mã khuyến mại ưu tiên `GET` `https://api.accesstrade.vn/v1/offers_informations/coupon_hot` #### Path Parameters | Name | Type | Description | | ----- | ------ | --------------------------------------------------------- | | limit | number | Số bản ghi giới hạn trên 1 trang | | date | number |

1 lấy khuyến mại hot theo tuần
2 lấy theo tháng

| {% tabs %} {% tab title="200 " %} ``` { "data": { "count": 1, "data": [ { "banner": [], "campaign": "322", "campaign_id": "4751584435713464237", "campaign_name": "Shopee Việt Nam Smartlink cho tất cả thiết bị", "categories": [ { "category_name": "EC-1", "category_name_show": "Điện thoại - Máy tính bảng", "category_no": "" }, { "category_name": "EC-2", "category_name_show": "Tivi-âm thanh", "category_no": "" } ], "coin_cap": 0, "coin_percentage": 0, "content": "VOUCHER GIẢM 20K DÀNH CHO KHÁCH HÀNG MỚI\nMã: NAFNEWBUYT9\n- Giảm tối đa 20K cho đơn hàng từ 50K trên app Shopee\n- Thời hạn áp dụng: đến 30/09/2021, 23H59\n- Lưu ý:\nSố lượng có hạn\nMỗi khách hàng chỉ sử dụng 1 lần\nChỉ áp dụng cho Khách hàng mới", "coupons": [ { "coupon_code": "NAFNEWBUYT9", "coupon_desc": "VOUCHER GIẢM 20K DÀNH CHO KHÁCH HÀNG MỚI", "coupon_save": "20000", "coupon_type": 5 } ], "ctime": { "$date": 1632996182570 }, "discount_percentage": 0, "discount_value": 0, "end_date": { "$date": 1633305600000 }, "id": "5756834766452765293", "image": "https://static.accesstrade.vn/adv/img/deal_coupons-30-09-2021-bvp0so.png", "is_hot": "True", "link": "https://shopee.vn/m/don-dau-tien-mien-phi?ref=sansandeals", "max_value": 0, "merchant": "shopee", "min_spend": 0, "name": "SHOPEE - VOUCHER GIẢM 20K DÀNH CHO KHÁCH HÀNG MỚI", "percentage_used": 100, "prod_link": "https://go.isclix.com/deep_link/4348611760548105593?url=https://shopee.vn/m/don-dau-tien-mien-phi?ref=sansandeals", "register": 1, "shop_id": 0, "start_date": { "$date": 1632960000000 }, "status": 1, "time_left": "Còn lại 1 ngày 7 giờ 48 phút" } ] }, "success": true } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | -------------------- | ------------------------------------------------------------------------------------------------------------------- | | banners | là 1 list chứa các dict banner, trong mỗi dict có: “link” - url banner, “width” - chiều rộng, “height” - chiều cao. | | content | Mô tả khuyến mại | | id | id khuyến mại | | image | url ảnh đại diện khuyến mại | | link | url khuyến mại | | merchant | nhà cung cấp mã khuyến mại | | categories | danh sách category của khuyến mại | | name | Tên khuyến mại | | start\_time | Thời gian bắt đầu khuyến mại | | end\_time | Thời gian kết thúc khuyến mại | | domain | Domain sản phẩm khuyến mại | | prod\_link | Affiliate link | | coupons | Chi tiết mã khuyến mại | | coin\_cap | Số tiền được khuyến mại | | coin\_percentage | Phần trăm khuyến mại | | percentage\_used | Phần trăm số lượng khuyến mại đã sử dụng | | discount\_value | Giá trị được giảm | | discount\_percentage | Phần trăm được giảm | ## Tìm kiếm mã khuyến mại theo link (Shopee & TIKI) `GET` `https://api.accesstrade.vn/v1/offers_informations/coupon` #### Path Parameters | Name | Type | Description | | ------------------------------------- | ------ | --------------------------------------------------------------------- | | URL\* | string | Đường dẫn sản phẩm để tìm kiếm mã khuyến mãi (có thể dùng short link) | {% tabs %} {% tab title="200 Gọi thành công và trả về danh sách mã" %} ``` { "data": { "count": 29, "count_current_day_coupon": 29, "count_next_day_coupon": 0, "data": [ { "banner": [], "campaign": "322", "campaign_id": "4751584435713464237", "campaign_name": "Shopee Việt Nam Smartlink cho tất cả thiết bị", "categories": [ { "category_name": "EC-29", "category_name_show": "Other", "category_no": "" } ], "coin_cap": 0, "coin_percentage": 0, "content": "La Roche-Posay Chính Hãng", "coupons": [ { "coupon_code": "LAROPH120", "coupon_desc": "Giảm 120,000 VNĐ cho đơn tối thiểu 1,000,000 VNĐ" } ], "ctime": "Sat, 02 Oct 2021 17:04:21 GMT", "discount_percentage": 0, "discount_value": 0, "end_date": "Sat, 02 Oct 2021 23:59:00 GMT", "id": "shopee-198385957076992", "image": "https://cf.shopee.vn/file/1be3baed98088f45bc368f1cb2a0e721", "is_hot": "False", "link": "https://shopee.vn/search?promotionId=198385957076992&signature=832e13655c20079f01701bd1efa734dee9584a87f2f069112b7107656f1b1496&voucherCode=LAROPH120&ref=sansandeals", "max_value": 0, "merchant": "shopee", "min_spend": 0, "name": "[La Roche-Posay Chính Hãng]-Giảm 120,000 VNĐ cho đơn tối thiểu 1,000,000 VNĐ", "percentage_used": 27, "prod_link": "https://go.isclix.com/deep_link/4348611760548105593?url=https://shopee.vn/search?promotionId=198385957076992&signature=832e13655c20079f01701bd1efa734dee9584a87f2f069112b7107656f1b1496&voucherCode=LAROPH120&ref=sansandeals", "register": 1, "shop_id": 37251700, "start_date": "Sat, 02 Oct 2021 00:18:00 GMT", "status": 1, "time_left": "Còn lại 0 ngày 6 giờ 55 phút" }, { "banner": [], "campaign": "322", "campaign_id": "4751584435713464237", "campaign_name": "Shopee Việt Nam Smartlink cho tất cả thiết bị", "categories": [ { "category_name": "EC-29", "category_name_show": "Other", "category_no": "" } ], "coin_cap": 0, "coin_percentage": 0, "content": "La Roche-Posay Chính Hãng", "coupons": [ { "coupon_code": "LAROPH85", "coupon_desc": "Giảm 85,000 VNĐ cho đơn tối thiểu 850,000 VNĐ" } ], "ctime": "Sat, 02 Oct 2021 17:04:21 GMT", "discount_percentage": 0, "discount_value": 0, "end_date": "Sat, 02 Oct 2021 23:59:00 GMT", "id": "shopee-198385084743680", "image": "https://cf.shopee.vn/file/1be3baed98088f45bc368f1cb2a0e721", "is_hot": "False", "link": "https://shopee.vn/search?promotionId=198385084743680&signature=ebbcec4bf0844fcdc49953c6b933d5e42aac1b1fe620d0c3aa7e740c3f67ef0c&voucherCode=LAROPH85&ref=sansandeals", "max_value": 0, "merchant": "shopee", "min_spend": 0, "name": "[La Roche-Posay Chính Hãng]-Giảm 85,000 VNĐ cho đơn tối thiểu 850,000 VNĐ", "percentage_used": 88, "prod_link": "https://go.isclix.com/deep_link/4348611760548105593?url=https://shopee.vn/search?promotionId=198385084743680&signature=ebbcec4bf0844fcdc49953c6b933d5e42aac1b1fe620d0c3aa7e740c3f67ef0c&voucherCode=LAROPH85&ref=sansandeals", "register": 1, "shop_id": 37251700, "start_date": "Sat, 02 Oct 2021 00:15:00 GMT", "status": 1, "time_left": "Còn lại 0 ngày 6 giờ 55 phút" }, { "banner": [], "campaign": "322", "campaign_id": "4751584435713464237", "campaign_name": "Shopee Việt Nam Smartlink cho tất cả thiết bị", "categories": [ { "category_name": "EC-29", "category_name_show": "Other", "category_no": "" } ], "coin_cap": 0, "coin_percentage": 0, "content": "Sử dụng mã miễn phí vận chuyển cho đơn hàng bất kì từ 0Đ thỏa điều kiện ưu đãi khi mua hàng trên Shopee:\r\n- Giảm tối đa 20K cho đơn hàng giao đến Hà Nội và Hồ Chí Minh.\r\n- Giảm tối đa 40K cho đơn hàng giao đến các tỉnh/thành phố khác.\r\nChỉ áp dụng cho đơn hàng đầu tiên của khách hàng mới.\r\nÁp dụng khi đặt hàng bằng ứng dụng Shopee.\r\nHình thức thanh toán: Tất cả.\r\nKênh vận chuyển khả dụng: Hỏa Tốc, Nhanh.\r\nMã chỉ được hoàn theo quy định của Shopee.\r\nHạn sử dụng từ 00:00 02/10/2021 - 23:58 02/10/2021.\r\nMã ưu đãi áp dụng với một số sản phẩm thuộc phạm vi chương trình. \r\nSố lượt sử dụng có hạn, chương trình và mã có thể kết thúc khi hết lượt ưu đãi hoặc khi hết hạn ưu đãi, tùy điều kiện nào đến trước.", "coupons": [ { "coupon_code": "FSV-192996067098624", "coupon_desc": "Đơn hàng đầu tiên" } ], "ctime": "Sat, 02 Oct 2021 00:21:04 GMT", "discount_percentage": 0, "discount_value": 0, "end_date": "Sat, 02 Oct 2021 23:58:00 GMT", "id": "shopee-192996067098624", "image": "https://content.accesstrade.vn/adv/1630740753_avatar_1630740753.gif", "is_hot": "False", "link": "https://shopee.vn/search?promotionId=192996067098624&signature=724443419ba6abaca74a7ded5fa99ddf837f858b26421c4ab39f4bc6b18d3d40&voucherCode=FSV-192996067098624&ref=sansandeals", "max_value": 0, "merchant": "shopee", "min_spend": 0, "name": "[SHOPEE]-Đơn hàng đầu tiên", "percentage_used": 30, "prod_link": "https://go.isclix.com/deep_link/4348611760548105593?url=https://shopee.vn/search?promotionId=192996067098624&signature=724443419ba6abaca74a7ded5fa99ddf837f858b26421c4ab39f4bc6b18d3d40&voucherCode=FSV-192996067098624&ref=sansandeals", "register": 1, "shop_id": null, "start_date": "Sat, 02 Oct 2021 00:00:00 GMT", "status": 1, "time_left": "Còn lại 0 ngày 6 giờ 54 phút" } ] }, "success": true } ``` {% endtab %} {% endtabs %} | Key | Mô tả | | -------------------- | ------------------------------------------------------------------------------------------------------------------- | | banners | là 1 list chứa các dict banner, trong mỗi dict có: “link” - url banner, “width” - chiều rộng, “height” - chiều cao. | | content | Mô tả khuyến mại | | id | id khuyến mại | | image | url ảnh đại diện khuyến mại | | link | url khuyến mại | | merchant | nhà cung cấp mã khuyến mại | | categories | danh sách category của khuyến mại | | name | Tên khuyến mại | | start\_time | Thời gian bắt đầu khuyến mại | | end\_time | Thời gian kết thúc khuyến mại | | domain | Domain sản phẩm khuyến mại | | prod\_link | Affiliate link | | coupons | Chi tiết mã khuyến mại | | coin\_cap | Số tiền được khuyến mại | | coin\_percentage | Phần trăm khuyến mại | | percentage\_used | Phần trăm số lượng khuyến mại đã sử dụng | | discount\_value | Giá trị được giảm | | discount\_percentage | Phần trăm được giảm |