Skip to main content

aligate

Real-time AliExpress data parser covering products, product reviews, sellers, store coupons, a seller's product catalog, 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. 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.3.0
  • Package version: 2.3.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_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.3.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.3.0
File Size Uploaded
aligate-2.3.0.tar.gz 57.1 kB Details

Built distribution (wheel)

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

Total release size: 170.1 kB

Release files / aligate-2.3.0.tar.gz

Download URL aligate-2.3.0.tar.gz
Size 57.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a9fc2cd6d409635f63a9418e67d856a7170149705f7bcd9da1ce63583e7b2314
BLAKE2b-256 checksum
How to use checksums
aadd51a8e48ff62046b86014acf0e4fa795273f3d514c5b2c75c5ec05181467e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jul 10, 2026.

Transparency log

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

Download URL aligate-2.3.0-py3-none-any.whl
Size 113.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
088b0b303b124e95650405f359e9b268e0b01f10a8324884652b9bd93b34c8f5
BLAKE2b-256 checksum
How to use checksums
caa6e421950cb3262602dad117fc4094a96145e61d16b0c0c688670c4155b768
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 Jul 10, 2026.

Transparency log

Release history Release notifications | RSS feed

2.7.0

2 release files

2.6.1

2 release files

2.5.0

2 release files

This release

2.3.0 This release

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