{"name":"AliExpress Product Reviews API","description":"Buyer reviews of an AliExpress product: review id score, review text and its English translation, review date, the buyer's country, the variant bought, shipping method, helpful votes and photos.","api_id":"generated_e304f8d171a4714164134ce6","slug":"aliexpress-product-reviews-api","source":{"name":"Aliexpress","domain":"feedback.aliexpress.com","url":"https://feedback.aliexpress.com/"},"category":"commerce","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-22","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-21T09:11:43.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_e304f8d171a4714164134ce6_search","name":"List AliExpress Product Reviews","description":"Return records within the accepted scope.","definition_version":"06444a03119f41cdb4bf21cf4ac8f4a8a653e36f55fab972e9780ba4fe0a2753","method":"POST","path":"/v1/catalog/public/apis/generated_e304f8d171a4714164134ce6/endpoints/generated_e304f8d171a4714164134ce6_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_e304f8d171a4714164134ce6/endpoints/generated_e304f8d171a4714164134ce6_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"filter":{"type":"string","enum":["all","image","additional"],"default":"all","description":"Optional. One verified value(s) of the page's own \"filter\" control (all = all; image = image; additional = additional). Omit it for the page's own selection."},"product_id":{"type":"string","minLength":1,"maxLength":200,"examples":["1005007483439417","1005007031110605"],"default":"1005007483439417","description":"Required. The source request's own \"productId\" value, sent exactly as typed."}},"required":["product_id"],"additionalProperties":false},"output_schema":{"additionalProperties":true,"properties":{"aigc":{"type":["boolean"]},"anonymous":{"type":["boolean"]},"buyerAddFbDays":{"type":["number"]},"buyerCountry":{"type":["string"]},"buyerEval":{"type":["number"]},"buyerFbType":{"type":["object"],"x-cleanedweb-source-value-opaque":true},"buyerFeedback":{"type":["string"]},"buyerGender":{"type":["string"]},"buyerHeadPortrait":{"type":["string"]},"buyerName":{"type":["string"]},"buyerProductFeedBack":{"type":["string"]},"buyerTranslationFeedback":{"type":["string"]},"downVoteCount":{"type":["number"]},"evalDate":{"type":["string"]},"evaluationId":{"type":["number"]},"evaluationIdStr":{"type":["string"]},"images":{"type":["array"],"x-cleanedweb-source-value-opaque":true},"independentSite":{"type":["boolean"]},"logistics":{"type":["string"]},"reviewLabel1":{"type":["string"]},"reviewLabel2":{"type":["string"]},"reviewLabel3":{"type":["string"]},"reviewLabelValue1":{"type":["string"]},"reviewLabelValue2":{"type":["string"]},"reviewLabelValue3":{"type":["string"]},"reviewType":{"type":["string"]},"samePurchaseSuggestion":{"type":["string"]},"selectedIcon":{"type":["string"]},"selectedReview":{"type":["boolean"]},"skuId":{"type":["number"]},"skuInfo":{"type":["string"]},"source_lang":{"type":["string"]},"status":{"type":["string"]},"thirdParty":{"type":["boolean"]},"thumbnails":{"type":["array"],"x-cleanedweb-source-value-opaque":true},"trendyol":{"type":["boolean"]},"type_translation_accepted":{"type":["string"]},"upVoteCount":{"type":["number"]}},"required":["evaluationId"],"type":"object"},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-21T09:11:43.446Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"aigc":false,"anonymous":true,"buyerAddFbDays":0,"buyerCountry":"US","buyerEval":100,"buyerFeedback":"Ten zestaw działa bez zarzutu. Mam nadzieję że długo podziała. Dźwięk super bas niezły to już 3 słuchawki jakie kupuje.","buyerName":"AliExpress Shopper","buyerTranslationFeedback":"This set works flawlessly. I hope it lasts long. The sound is great, bass is nice. This is already the third pair of headphones I've bought.","downVoteCount":0,"evalDate":"28 Nov 2025","evaluationId":60094007135819280,"evaluationIdStr":"60094007135819284","images":["https://ae-pic-a1.aliexpress-media.com/kf/A95714517627e48be8ce2d0195e750f5e4.jpg","https://ae-pic-a1.aliexpress-media.com/kf/Adc04870b6e3e41fcb4e8d868109da1514.jpg"],"independentSite":false,"logistics":"Aliexpress Selection Standard","reviewLabel1":"Quality of sound","reviewLabel2":"Durability","reviewLabel3":"User Friendly ","reviewLabelValue1":"Fast","reviewLabelValue2":"Fast","reviewLabelValue3":"Good","reviewType":"REVIEW","samePurchaseSuggestion":"Buy the same","selectedIcon":"https://ae-pic-a1.aliexpress-media.com/kf/S2df5f3fa0d8242b1a0bbb1cc92cab109P/221x221.png","selectedReview":true,"skuId":12000040946194042,"skuInfo":"Color:black","source_lang":"en","status":"1","thirdParty":false,"thumbnails":["https://ae-pic-a1.aliexpress-media.com/kf/A95714517627e48be8ce2d0195e750f5e4.jpg_220x220.jpg","https://ae-pic-a1.aliexpress-media.com/kf/Adc04870b6e3e41fcb4e8d868109da1514.jpg_220x220.jpg"],"trendyol":false,"type_translation_accepted":"crowdsourcing","upVoteCount":0},{"aigc":false,"anonymous":true,"buyerAddFbDays":0,"buyerCountry":"US","buyerEval":40,"buyerFeedback":"nothing like what i ordered before. its has a voice to indicate connection instead of the beeps it originally had. its case is mate, and the headphones are tighter/uncomfortable. if i knew the product changed this much I would havw never reorder it. and the pdf manual is rlly blury and unreadable","buyerName":"AliExpress Shopper","buyerTranslationFeedback":"Nothing like what i ordered before. its has a voice to indicate connection instead of the beeps it originally had. its case is mate, and the headphones are tighter/uncomfortable. if i knew the product changed this much i would havw never reorder it. and the pdf manual is rlly blury and unreadable","downVoteCount":0,"evalDate":"02 Jul 2026","evaluationId":60097789176499440,"evaluationIdStr":"60097789176499443","independentSite":false,"logistics":"AliExpress Selection Standard Shipping","reviewLabel1":"Quality of sound","reviewLabel2":"Durability","reviewLabel3":"User Friendly ","reviewLabelValue1":"Fits ok ","reviewLabelValue2":"Fits ok ","reviewLabelValue3":"Difficult","reviewType":"REVIEW","samePurchaseSuggestion":"Buy the same","selectedReview":false,"skuId":12000040946194042,"skuInfo":"Color:black","source_lang":"en","status":"1","thirdParty":false,"trendyol":false,"type_translation_accepted":"crowdsourcing","upVoteCount":0}]}],"request_example":{"body":{"input":{"product_id":"1005007483439417","filter":"all"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_e304f8d171a4714164134ce6/endpoints/generated_e304f8d171a4714164134ce6_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"product_id\": \"1005007483439417\",\n    \"filter\": \"all\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_e304f8d171a4714164134ce6/endpoints/generated_e304f8d171a4714164134ce6_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/aliexpress-product-reviews-api/","markdown":"https://cleanedweb.com/catalog/aliexpress-product-reviews-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_e304f8d171a4714164134ce6/endpoints/generated_e304f8d171a4714164134ce6_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/aliexpress-product-reviews-api/","markdown":"https://cleanedweb.com/catalog/aliexpress-product-reviews-api/index.md","contract":"https://cleanedweb.com/catalog/aliexpress-product-reviews-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
