Endpoint Playground

Try the Shopee Homepage Banners API

Returns homepage merchandising banners for one slot from the credential-free `api/v4/banner/batch_list_by_spaces` POST JSON. Public, credential-free endpoint.

What a live request returned

29 Oct 2026: 3 banners; 7 fields had a value in every checked item.

Observed request: GET /shopee/banners?slot=HOME_CAROUSEL_01
Fields with a value in every checked item: banner_id, campaign_unit_id, slot_id, image, url, start_time, end_time

Sample value profiles: start_time: 2026-10-25; image: cf.shopee.com.my; url: shopee.com.my.

Request: GET /shopee/banners
Cost: 2 credits/request
Auth: apiKey

Shopee Homepage Banners API documentation Shopee platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/shopee/banners?region=my&slot=HOME_CAROUSEL_01' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
region	string	No	my	Shopee region: my, sg, id, th, vn, ph, tw, br, mx, co, cl (default my)
slot	string	No	HOME_CAROUSEL_01	Banner slot: HOME_CAROUSEL_01, HOME_SKINNY_01, HOME_NUZ_CAROUSEL_01, HOME_FLOATING, HOME_POPUP_01, HOME_MALL_01 (default HOME_CAROUSEL_01)
space_key	string	No		Raw PC-<CC>-<SLOT> space key override

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region": "my",
    "slot": "HOME_CAROUSEL_01",
    "space_key": "PC-MY-HOME_CAROUSEL_01",
    "ratio": 3.333,
    "banners": [
      {
        "banner_id": 265864,
        "campaign_unit_id": 163078,
        "slot_id": 2,
        "image": "https://cf.shopee.com.my/file/my-111",
        "url": "https://shopee.com.my/m/11-11#CS1",
        "start_time": 1792944000,
        "end_time": 1793289599
      }
    ]
  }
}

More Shopee endpoints

Get the Shopee category tree Get localized Shopee category details Get the Shopee footer layout Get Shopee homepage category tiles Get Shopee location filter vocabulary Get Shopee's official-shop category directory Get Shopee search landing prefills Get Shopee search filter vocabulary Get Shopee keyword hints Get Shopee search suggestions

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestshopee.bannersResponseDocShopee

GET /shopee/banners

Get Shopee homepage banners

Returns homepage merchandising banners for one slot from the credential-free `api/v4/banner/batch_list_by_spaces` POST JSON. Public, credential-free endpoint.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region": "my",
    "slot": "HOME_CAROUSEL_01",
    "space_key": "PC-MY-HOME_CAROUSEL_01",
    "ratio": 3.333,
    "banners": [
      {
        "banner_id": 265864,
        "campaign_unit_id": 163078,
        "slot_id": 2,
        "image": "https://cf.shopee.com.my/file/my-111",
        "url": "https://shopee.com.my/m/11-11#CS1",
        "start_time": 1792944000,
        "end_time": 1793289599
      }
    ]
  }
}

Endpoint Playground

Try the Shopee Homepage Banners API

Returns homepage merchandising banners for one slot from the credential-free `api/v4/banner/batch_list_by_spaces` POST JSON. Public, credential-free endpoint.

What a live request returned

29 Oct 2026: 3 banners; 7 fields had a value in every checked item.

Observed request: GET /shopee/banners?slot=HOME_CAROUSEL_01
Fields with a value in every checked item: banner_id, campaign_unit_id, slot_id, image, url, start_time, end_time

Sample value profiles: start_time: 2026-10-25; image: cf.shopee.com.my; url: shopee.com.my.

Request: GET /shopee/banners
Cost: 2 credits/request
Auth: apiKey

Shopee Homepage Banners API documentation Shopee platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/shopee/banners?region=my&slot=HOME_CAROUSEL_01' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
region	string	No	my	Shopee region: my, sg, id, th, vn, ph, tw, br, mx, co, cl (default my)
slot	string	No	HOME_CAROUSEL_01	Banner slot: HOME_CAROUSEL_01, HOME_SKINNY_01, HOME_NUZ_CAROUSEL_01, HOME_FLOATING, HOME_POPUP_01, HOME_MALL_01 (default HOME_CAROUSEL_01)
space_key	string	No		Raw PC-<CC>-<SLOT> space key override

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region": "my",
    "slot": "HOME_CAROUSEL_01",
    "space_key": "PC-MY-HOME_CAROUSEL_01",
    "ratio": 3.333,
    "banners": [
      {
        "banner_id": 265864,
        "campaign_unit_id": 163078,
        "slot_id": 2,
        "image": "https://cf.shopee.com.my/file/my-111",
        "url": "https://shopee.com.my/m/11-11#CS1",
        "start_time": 1792944000,
        "end_time": 1793289599
      }
    ]
  }
}

More Shopee endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestshopee.bannersResponseDocShopee

GET /shopee/banners

Get Shopee homepage banners

Returns homepage merchandising banners for one slot from the credential-free `api/v4/banner/batch_list_by_spaces` POST JSON. Public, credential-free endpoint.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region": "my",
    "slot": "HOME_CAROUSEL_01",
    "space_key": "PC-MY-HOME_CAROUSEL_01",
    "ratio": 3.333,
    "banners": [
      {
        "banner_id": 265864,
        "campaign_unit_id": 163078,
        "slot_id": 2,
        "image": "https://cf.shopee.com.my/file/my-111",
        "url": "https://shopee.com.my/m/11-11#CS1",
        "start_time": 1792944000,
        "end_time": 1793289599
      }
    ]
  }
}