Shopee Affiliate icon

Shopee Affiliate

Shopee Affiliate API

Search Products

AI-generated

Summary

Searches Shopee Affiliate (Brazil) product offers via the GraphQL productOfferV2 query, filtered by keyword, shop, category and offer type, and returns the raw API response with product and pagination data.

Inputs

  • keyword — Product name search text. Omitted from the query when empty. It is interpolated into the query unescaped.
  • shopId — Restrict results to one shop. Ignored when 0.
  • productCatId — Restrict results to a Shopee category ID. Ignored when 0.
  • sortType — Sort order: 1 Relevance (default), 2 Items Sold, 3 Price Desc, 4 Price Asc, 5 Commission Desc.
  • page — Page number of results (default 1).
  • limit — Maximum number of products to return (default 10).
  • isAMSOffer — When true, only offers with seller (AMS) commission. When false, the filter is not sent.
  • isKeySeller — When true, only offers from Shopee key sellers. When false, the filter is not sent.
  • shortlink — When true (default), requests offerLink, the affiliate-tracked short link, for each product.
  • thumbnail — When true, adds a miniatura field to each product with a Google Sheets =IMAGE(...) formula built from imageUrl.

Output shape

One output item per input item. Its json is the full GraphQL response: data.productOfferV2.nodes (an array of products) and data.productOfferV2.pageInfo (page, limit, hasNextPage). Products are not split into separate items.

Each product has itemId, productName, priceMin, priceMax, priceDiscountRate, sales, commissionRate, sellerCommissionRate, shopeeCommissionRate, commission, ratingStar, imageUrl, shopId, shopName, productLink, offerLink (only if Short Link is on), productCatIds, shopType, periodStartTime and periodEndTime. GraphQL errors throw a node error. Requires Shopee Affiliate API credentials (App ID and Secret), and the request is signed with SHA256. Use hasNextPage and Page to paginate.

Examples

Example 1: Find the top-commission products for a keyword

Keyword='fone bluetooth', Sort Type=Commission Desc, Limit=20, Short Link=true

Example 2: List best-selling products from one shop for a Google Sheets catalog

Shop ID=12345, Sort Type=Items Sold, Thumbnail=true, Limit=50

Example 3: Page through key-seller AMS offers in a category

Category ID=100630, AMS Offer=true, Key Seller=true, Page=2, Limit=10

Links

Discussion