Skip to main content

aligate

Real-time AliExpress data parser covering products, product reviews, sellers, store coupons, a seller's product catalog, product shipping, and product search by text or image. Products: pricing, stock status, shipping options, seller information, product configurations (SKUs), and more - scoped to a specific country and currency. Reviews: customer ratings and feedback for a product. Sellers: full store profile with ratings, feedback, and categories. Coupons: active seller coupon codes with discounts, thresholds, budgets, and expiry. Seller products: a store's product catalog, paginated and best-selling first. Shipping: shipping methods for a product with cost, carrier, and delivery estimate. Search: find products by keyword or by uploading an image, returning paginated product results with their categories.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 2.5.0
  • Package version: 2.5.0
  • Generator version: 7.23.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.10+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import aligate

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import aligate

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import aligate
from aligate.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://aligate-aliexpress-data-api.p.rapidapi.com
# See configuration.py for a list of all supported configuration parameters.
configuration = aligate.Configuration(
    host = "https://aligate-aliexpress-data-api.p.rapidapi.com"
)



# Enter a context with an instance of the API client
with aligate.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = aligate.DefaultApi(api_client)
    product_id = 1005004530469845 # int | AliExpress product ID, taken from the product page URL.
    country = 'PL' # str | Country code (ISO 3166-1 alpha-2) used for pricing and shipping eligibility.
    currency = 'PLN' # str | Currency code (ISO 4217) for the returned prices.
    locale = en_US # str | Response language locale. (optional) (default to en_US)
    with_welcome_discount = False # bool | Apply the new-buyer welcome discount to the returned price. (optional) (default to False)
    with_description = False # bool | Fetch the full product description (formatted HTML, plain text, and image gallery), returned in the `description` field. Note: enabling this adds approximately 600-750 ms to the response time.  (optional) (default to False)

    try:
        # Get Product Info
        api_response = api_instance.get_product_info(product_id, country, currency, locale=locale, with_welcome_discount=with_welcome_discount, with_description=with_description)
        print("The response of DefaultApi->get_product_info:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling DefaultApi->get_product_info: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://aligate-aliexpress-data-api.p.rapidapi.com

Class Method HTTP request Description
DefaultApi get_product_info GET /api/v2/product Get Product Info
DefaultApi get_product_reviews GET /api/v2/product/reviews Get Product Reviews
DefaultApi get_product_shipping GET /api/v2/product/shipping-h5 Get Product Shipping
DefaultApi get_seller_coupons GET /api/v2/seller/coupons Get Seller Coupons
DefaultApi get_seller_info GET /api/v2/seller Get Seller Info
DefaultApi get_seller_products GET /api/v2/seller/products Get Seller Products
DefaultApi health_check GET /api/v2/health Health check
DefaultApi search_by_image POST /api/v2/search/image Search By Image
DefaultApi search_by_image_url GET /api/v2/search/image Search By Image URL
DefaultApi search_by_text GET /api/v2/search/text Search By Text

Documentation For Models

Documentation For Authorization

Endpoints do not require authorization.

Author

Release files for aligate 2.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aligate 2.5.0
File Size Uploaded
aligate-2.5.0.tar.gz 59.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aligate 2.5.0
File Interpreter ABI Platform
aligate-2.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 178.2 kB

Release files / aligate-2.5.0.tar.gz

Download URL aligate-2.5.0.tar.gz
Size 59.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5b6173018464a5a22610a275c87d486c68db7a0c6dbe8261436e623c2a26cb13
BLAKE2b-256 checksum
How to use checksums
e4323e841e23a903215a17de5efa945406dacf8d7dd4020fa1453fdb2ad9eeaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.

Transparency log

Release files / aligate-2.5.0-py3-none-any.whl

Download URL aligate-2.5.0-py3-none-any.whl
Size 119.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
17f77a85a4ae6475757873bcc03e2e1bf0d147365acf9cf90a60d73c094fe7b4
BLAKE2b-256 checksum
How to use checksums
ebab3ef168c1dd77703bd872d540d17f5f66d94ffd084ecb33a66f4ae3c2efd6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 13, 2026.

Transparency log

Release history Release notifications | RSS feed

2.7.0

2 release files

2.6.1

2 release files

This release

2.5.0 This release

2 release files

2.3.0

2 release files

2.1.1

2 release files

2.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page