跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
营销与销售

aliexpress-product-data

Search AliExpress, browse a category, pull one product with every SKU variant, read translated buyer reviews, and open a seller's storefront and catalogue. 6 endpoints, 1 credit each, structured JSON.

scavio-ai · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add scavio-ai/skills --skill aliexpress-product-data

技能说明


name: aliexpress-product-data description: Search AliExpress, browse a category, pull one product with every SKU variant, read translated buyer reviews, and open a seller's storefront and catalogue. 6 endpoints, 1 credit each, structured JSON. version: 1.0.0 tags: aliexpress, product-data, ecommerce, price-tracking, product-search, sku-variants, product-reviews, seller-data, dropshipping, market-research, price-comparison, catalog, listings, agents, structured-data, json, ai-agents, scraping-api metadata: openclaw: requires: env: - SCAVIO_API_KEY primaryEnv: SCAVIO_API_KEY timeout: 120 throttle: 1 emoji: "\U0001F6D2" homepage: https://scavio.dev/docs?utm_source=agent-skills&utm_medium=skill&utm_campaign=aliexpress-product-data

AliExpress Product Data API - Search, Category, Reviews, Seller

Search AliExpress products, browse a category, pull one product in full with all its SKU variants, read translated customer reviews, and open a seller's storefront and catalogue. All endpoints return structured JSON.

When to trigger

Use this skill when the user asks to:

  • Search AliExpress for a product with price, rating, units-sold and free-shipping filters
  • Browse a whole AliExpress category and sort by best sellers (units ordered)
  • Pull one product in full - current and original price, discount, every SKU variant group, the full image gallery, and the seller
  • Read translated buyer reviews with star rating, buyer country, per-SKU variant and photos
  • Open a seller's profile (followers, rating, catalogue size) and page through their catalogue
  • Do price comparison, dropshipping research, or product-market research on AliExpress

Setup

Get a free API key at scavio.dev (50 free credits to get started, no card required):

export SCAVIO_API_KEY=sk_live_your_key

If you do not have a key yet

An agent running this skill without SCAVIO_API_KEY set will get 401 on every call below. The whole path from nothing to a working key is self-serve:

  1. Sign up at dashboard.scavio.dev - email or Google, no card required.
  2. A key is created for the account automatically at signup. It is on the dashboard under API Keys, ready to copy.
  3. A new account starts with 50 credits. Endpoints in this skill cost 1 credit each unless the table below says otherwise.

When the balance runs out the API answers 402 with a JSON body carrying billing_url. Topping up needs no code change - the same key keeps working. The smallest purchase is 2,500 credits for $25, and monthly plans work out cheaper per credit if the usage is steady rather than one-off.

Every request is a POST with a JSON body and:

Authorization: Bearer $SCAVIO_API_KEY

Endpoints

Base URL: https://api.scavio.dev. Every AliExpress endpoint costs 1 credit.

EndpointCreditsWhat it returns
POST /api/v1/aliexpress/search1Products for a query: price with discounts, rating, units sold, delivery estimate, ship-from country, images, plus related search terms
POST /api/v1/aliexpress/category1Products within a category id, same product shape and filters as search. Sort by orders for the category's best sellers
POST /api/v1/aliexpress/reviews1Customer reviews: text with English translation, star rating, buyer country, per-SKU variant, photos, votes, and the product's full rating breakdown. Up to 50 per call
POST /api/v1/aliexpress/product1One product in full: title, current/original price, discount, rating, review count, every SKU variant group with options, full image gallery, free-shipping flag, seller (store name, id, positive-feedback rate, followers). Typically responds in 20-60 seconds
POST /api/v1/aliexpress/seller1A storefront profile: name, store id, follower count, plus rating, opening date and catalogue size when published. Typically responds in 20-60 seconds
POST /api/v1/aliexpress/seller-products1A seller's catalogue, 30 items per page, with total_products reporting the full size. Typically responds in 20-60 seconds

Two facts that decide how you call this

search and category share one product shape. The same filters (sort_by, min_price, max_price, ship_from, free_shipping, ship_to, currency) apply to both. Use search for a keyword, category for a category id.

ship_to changes what appears, not just prices. The 2-letter destination country changes prices, VAT and delivery estimates - and which items appear at all, because AliExpress filters by shippability. Send it explicitly for a stable result.

When you set min_price/max_price, total_results comes back null. AliExpress reports a broadened match count under a price filter, so the total is suppressed rather than shown wrong. The products array is still correct.

Parameters

Search (/search)

ParameterTypeDefaultDescription
querystringrequiredSearch terms (1-500 chars)
category_idstring--Restrict the search to one category id
pageinteger--1-based, 60 items per full page
sort_bystringbest_matchbest_match, orders (units sold), price_low, price_high
min_price / max_pricenumber--Price filter, in the selected currency
ship_fromstring--Only items shipped from this 2-letter country (e.g. US, CN)
free_shippingboolean--Only items with free shipping
ship_tostringUS2-letter ISO destination country
currencystringUSD3-letter ISO currency

Category (/category)

Same fields as search, but category_id is required and there is no query.

Reviews (`/review

阅读完整来源 ↗