AliExpress Open Platform API

Name: AliExpress Open Platform API API
Brand: AliExpress Open Platform API
Availability: InStock

★ Only Publicly Available SpecE CommerceStorefrontapiKey185 EndpointsREST

For Agents

Operate on the AliExpress marketplace as a seller, affiliate, dropshipper, or logistics partner - manage products, orders, shipping, refunds, and affiliate links across 185 methods.

Quickstart

Get started with AliExpress Open Platform API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"generate an AliExpress affiliate link"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with AliExpress Open Platform API API.

Generate, refresh, and secure-refresh access tokens for AliExpress accounts via /auth/token endpoints

Generate affiliate product links and pull product details, hot products, and promotional campaigns via /aliexpress/affiliate/* methods

List, query, and inspect affiliate orders and commissions via /aliexpress/affiliate/order/list and /aliexpress/affiliate/order/get

Submit shipment declarations and pack orders for AliExpress logistics via /aliexpress/asf/* methods

GET STARTED

Start building with AliExpress Open Platform API API

Explore with Jentic

View OpenAPI Spec

Use for: I need to generate an affiliate link for an AliExpress product, Get the list of AliExpress affiliate orders for the past 7 days, Refresh an expired AliExpress access token, Look up product details for a given AliExpress product ID

Not supported: Does not handle direct payment processing, off-marketplace fulfillment, or buyer-side checkout - use a payment gateway, third-party logistics provider, or AliExpress's consumer site for those. Use this API for marketplace seller, affiliate, dropshipper, and logistics-partner operations only.

Jentic publishes the only available OpenAPI specification for AliExpress Open Platform API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for the AliExpress Open Platform API, keeping it validated and agent-ready. The Open Platform exposes 185 endpoints for sellers, affiliates, dropshippers, and logistics partners to manage products, orders, shipping, payments, and refunds across the AliExpress marketplace. The API follows the TOP (Taobao Open Platform) gateway pattern - most operations are dispatched through a central gateway endpoint with method-specific paths under the /aliexpress/ prefix - and authenticates via app key and access token query parameters obtained through OAuth-style token endpoints.

Use Cases

Patterns agents use AliExpress Open Platform API API for, with concrete tasks.

★ Affiliate link generation for content sites

Content sites and price-comparison engines call /aliexpress/affiliate/link/generate with a tracking ID and one or more source URLs to receive trackable affiliate links. Combined with /aliexpress/affiliate/productdetail/get for live price and stock, sites can publish AliExpress deals with accurate data and earn commission on conversions.

POST /aliexpress/affiliate/link/generate with tracking_id and source_values containing the AliExpress product URL, then POST /aliexpress/affiliate/productdetail/get to enrich the listing

Dropshipper order placement and tracking

Dropshippers integrate with /aliexpress/dropshipper methods to push customer orders into AliExpress, then pull shipment status and tracking information through /aliexpress/asf logistics endpoints. The flow keeps inventory off the dropshipper's books while still surfacing accurate ship and delivery dates to end customers.

Call the AliExpress dropshipper order-placement method with the customer order, then POST /aliexpress/asf/order/shipping/service/get to retrieve shipping options

Marketplace seller catalog automation

Sellers automate listing creation by calling category and attribute lookup methods, then product creation methods under /aliexpress/seller and /aliexpress/category&attributes. Image uploads via /aliexpress/image complete the listing without using the seller dashboard, enabling bulk PIM-driven catalog management.

Call /aliexpress/affiliate/category/get to discover the target category, look up required attributes, then create the listing through the seller-product creation method

Agent-driven affiliate research

An AI assistant connecting through Jentic can search AliExpress for hot products in a niche, pull product details, generate trackable affiliate links, and return a curated list to the user. Credentials and the access token stay in the Jentic vault, so the agent never handles the raw app key or access token.

Search Jentic for 'find AliExpress hot products', load aliexpress_affiliate_hotproduct_query, execute for the niche, then call aliexpress_affiliate_link_generate for each selected product

Key Endpoints

185 endpoints — jentic publishes the only available openapi specification for the aliexpress open platform api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/auth/token/create

Generate an access token from an authorization code

POST

/auth/token/refresh

Refresh an expired access token

POST

/aliexpress/affiliate/link/generate

Generate an affiliate tracking link

POST

/aliexpress/affiliate/productdetail/get

Get detailed product information

POST

/aliexpress/affiliate/hotproduct/query

Query hot products in a category

POST

/aliexpress/affiliate/order/list

List affiliate orders

POST

/aliexpress/asf/order/shipping/service/get

Retrieve shipping service options for an order

POST

/auth/token/create

Generate an access token from an authorization code

POST

/auth/token/refresh

Refresh an expired access token

POST

/aliexpress/affiliate/link/generate

Generate an affiliate tracking link

POST

/aliexpress/affiliate/productdetail/get

Get detailed product information

POST

/aliexpress/affiliate/hotproduct/query

Query hot products in a category

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

AliExpress app_key and access_token query parameters are stored encrypted in the Jentic vault. Agents receive a scoped Jentic token at request time; the raw app key and access token never enter agent context.

Intent-based discovery

Agents search Jentic by intent (e.g. 'generate AliExpress affiliate link' or 'list AliExpress affiliate orders') and Jentic returns the matching method from the 185-method catalog with its input schema.

Time to first call

Direct integration: 3-5 days to map the TOP gateway pattern, wire OAuth-style token refresh, and discover relevant methods. Through Jentic: under 1 hour - search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Shopify API

Run your own storefront rather than selling through a marketplace

Choose Shopify when the seller wants to own the customer relationship and storefront rather than leveraging AliExpress traffic.

Alternative

Etsy API

Marketplace API focused on handmade and vintage goods

Choose Etsy for handmade, craft, or vintage categories where AliExpress's mass-market positioning is a poor fit.

Alternative

eBay Marketing API

Auction and fixed-price marketplace with strong second-hand and collectibles focus

Choose eBay when targeting auction-format selling or US/EU buyers where AliExpress shipping times are unattractive.

FAQs

Specific to using AliExpress Open Platform API API through Jentic.

Why is there no official OpenAPI spec for the AliExpress Open Platform API?

AliExpress documents methods through its TOP-style developer portal but does not publish a packaged OpenAPI 3 specification. Jentic generates and maintains this spec so that AI agents and developers can call the Open Platform via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the AliExpress Open Platform API use?

Two API key parameters passed in the query string: app_key (your registered application key) and access_token (obtained via /auth/token/create after the user authorizes your app). Through Jentic, both are stored in the vault and injected at request time.

Can I generate affiliate links with this API?

Yes. POST /aliexpress/affiliate/link/generate with your tracking_id and the source product URLs. The response returns affiliate-trackable links suitable for embedding in content sites and apps.

What are the rate limits for the AliExpress Open Platform?

The spec does not declare numeric rate limits. AliExpress applies per-app and per-method throttling that varies by service tier. Watch for error codes indicating throttling and refresh access tokens proactively before expiry to avoid mid-batch failures.

How do I refresh an access token through Jentic?

Search Jentic for 'refresh AliExpress access token', load refreshToken, and execute with the stored refresh_token. Jentic injects the app_key and stores the new access_token back in the vault for subsequent calls.

Does this API include logistics endpoints?

Yes. The /aliexpress/asf/* methods cover shipment declaration, packing, and shipping service queries for AliExpress's logistics network, including DBS (Direct Business Shipping) and local-to-local fulfillment paths.