> ## Documentation Index > Fetch the complete documentation index at: https://docs.anysite.io/llms.txt > Use this file to discover all available pages before exploring further. # /aliexpress/products/search > Search AliExpress products by keyword. Returns product cards with id, title, image and images, sale and original price, discount, rating, sold counts, AliExpress Choice and sponsored flags, listing date, category ids, estimated delivery window and promotional selling points. Supports sorting, price range, ship-from country, the Choice, free-shipping, local-shipping and 4-stars-and-up switches, the keyword's own attribute facets, plus an independent ship-to country, content language and currency. **Price:** 20 credits per 60 results **⚠️ Common errors:** 422: Filter group or value not offered for this keyword — note AliExpress ships facet values incompletely and inconsistently, so a rarely-offered value can be rejected even though it exists, and repeating the call can resolve it; or a shipping region AliExpress serves from a separate regional marketplace this endpoint does not cover ## OpenAPI ````yaml /openapi/e-commerce-marketplaces.json post /api/aliexpress/products/search openapi: 3.1.0 info: title: Any Site API description: >+ Any Site API provides programmatic access to data from LinkedIn, Instagram, Twitter, and other platforms. ## Authentication All API endpoints require an `access-token` header with a valid API token. Tokens can be created in the [dashboard](https://app.anysite.io/). ## Pricing Each endpoint has a credit cost listed in its description. Credits are deducted from your token balance per request. version: 0.0.1 servers: [] security: - AccessToken: [] paths: /api/aliexpress/products/search: post: tags: - /aliexpress summary: /aliexpress/products/search description: >- Search AliExpress products by keyword. Returns product cards with id, title, image and images, sale and original price, discount, rating, sold counts, AliExpress Choice and sponsored flags, listing date, category ids, estimated delivery window and promotional selling points. Supports sorting, price range, ship-from country, the Choice, free-shipping, local-shipping and 4-stars-and-up switches, the keyword's own attribute facets, plus an independent ship-to country, content language and currency. **Price:** 20 credits per 60 results **⚠️ Common errors:** 422: Filter group or value not offered for this keyword — note AliExpress ships facet values incompletely and inconsistently, so a rarely-offered value can be rejected even though it exists, and repeating the call can resolve it; or a shipping region AliExpress serves from a separate regional marketplace this endpoint does not cover operationId: __api_aliexpress_products_search_post parameters: - name: access-token in: header required: true schema: anyOf: - type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AliexpressProductsSearchPayload' responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/AliexpressSearchProduct' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: AliexpressProductsSearchPayload: properties: timeout: type: integer maximum: 1500 minimum: 20 default: 300 language: $ref: '#/components/schemas/AliexpressLanguage' default: en_US currency: $ref: '#/components/schemas/AliexpressCurrency' default: USD keyword: type: string minLength: 1 count: type: integer minimum: 1 sort: $ref: '#/components/schemas/AliexpressSortType' default: best_match min_price: anyOf: - type: number minimum: 0 - type: 'null' max_price: anyOf: - type: number minimum: 0 - type: 'null' country: $ref: '#/components/schemas/AliexpressCountry' default: US ship_from: anyOf: - $ref: '#/components/schemas/AliexpressCountry' - type: 'null' free_shipping: type: boolean default: false choice: type: boolean default: false four_star_and_up: type: boolean default: false local_shipping: type: boolean default: false filters: items: type: string type: array default: [] type: object required: - keyword - count AliexpressSearchProduct: properties: '@type': type: string default: AliexpressSearchProduct id: type: string product_url: type: string product_title: anyOf: - type: string - type: 'null' image: anyOf: - type: string - type: 'null' images: items: type: string type: array default: [] price: anyOf: - type: number - type: 'null' price_text: anyOf: - type: string - type: 'null' original_price: anyOf: - type: number - type: 'null' original_price_text: anyOf: - type: string - type: 'null' currency: anyOf: - type: string - type: 'null' discount: anyOf: - type: integer - type: 'null' rating: anyOf: - type: number - type: 'null' sold_text: anyOf: - type: string - type: 'null' sold_count: anyOf: - type: integer - type: 'null' is_choice: type: boolean default: false is_sponsored: type: boolean default: false listed_at: anyOf: - type: integer - type: 'null' listed_at_text: anyOf: - type: string - type: 'null' sku_id: anyOf: - type: string - type: 'null' category_ids: items: type: string type: array default: [] delivery_min_days: anyOf: - type: integer - type: 'null' delivery_max_days: anyOf: - type: integer - type: 'null' selling_points: items: type: string type: array default: [] type: object required: - id - product_url HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array type: object AliexpressLanguage: type: string enum: - ar_MA - de_DE - en_US - es_ES - fr_FR - in_ID - it_IT - iw_IL - ja_JP - ko_KR - nl_NL - pl_PL - pt_BR - ru_RU - th_TH - tr_TR - vi_VN AliexpressCurrency: type: string enum: - USD - EUR - GBP - CAD - AUD - RUB - BRL - CLP - JPY - KRW - CHF - SEK - PLN - ILS - NOK - DKK - NZD - MXN - COP - TRY - THB - SGD - MYR - PHP - IDR - INR - VND - HKD - TWD - AED - SAR - CZK - HUF - RON - BGN - UAH - KZT - ARS - EGP - ZAR - CNY - PEN AliexpressSortType: type: string enum: - best_match - orders - price_low_to_high - price_high_to_low AliexpressCountry: type: string enum: - AD - AE - AF - AG - AI - AL - AM - AN - AO - AR - AS - ASC - AT - AU - AW - AX - AZ - BA - BB - BD - BE - BF - BG - BH - BI - BJ - BL - BM - BN - BO - BQ - BR - BS - BT - BW - BY - BZ - CA - CC - CD - CF - CG - CH - CI - CK - CL - CM - CO - CR - CV - CW - CX - CY - CZ - DE - DJ - DK - DM - DO - DZ - EAZ - EC - EE - EG - ER - ES - ET - FI - FJ - FK - FM - FO - FR - GA - GBA - GD - GE - GF - GG - GH - GI - GL - GM - GN - GP - GQ - GR - GS - GT - GU - GW - GY - HK - HN - HR - HT - HU - IE - IL - IQ - IS - IT - JE - JM - JO - JP - KE - KG - KH - KI - KM - KN - KR - KS - KW - KY - KZ - LA - LB - LC - LI - LK - LR - LS - LT - LU - LV - LY - MA - MC - MD - ME - MF - MG - MH - MK - ML - MM - MN - MO - MP - MQ - MR - MS - MT - MU - MV - MW - MX - MY - MZ - NA - NC - NE - NF - NG - NI - NL - 'NO' - NP - NR - NU - NZ - OM - PA - PE - PF - PG - PH - PK - PL - PM - PR - PS - PT - PW - PY - QA - RE - RO - RU - RW - SA - SB - SC - SE - SG - SI - SK - SL - SM - SN - SO - SR - SRB - SS - ST - SV - SX - SZ - TC - TD - TG - TH - TJ - TL - TM - TN - TO - TR - TT - TV - TW - TZ - UA - UG - UK - US - UY - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - YE - YT - ZA - ZM - ZW ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array msg: type: string type: type: string input: {} ctx: type: object type: object required: - loc - msg - type securitySchemes: AccessToken: type: apiKey in: header name: access-token description: API token from the dashboard ````