components: schemas: AsinToGtinData: additionalProperties: true properties: asin: title: Asin type: string results: items: $ref: '#/components/schemas/GtinResult' title: Results type: array required: - asin - results title: AsinToGtinData type: object AsinToGtinParameters: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string required: - asin - country title: AsinToGtinParameters type: object AsinToGtinResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/AsinToGtinData' parameters: $ref: '#/components/schemas/AsinToGtinParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: AsinToGtinResponse type: object BestSellerProduct: additionalProperties: true properties: asin: anyOf: - type: string - type: 'null' title: Asin product_num_ratings: anyOf: - type: integer - type: 'null' title: Product Num Ratings product_photo: anyOf: - type: string - type: 'null' title: Product Photo product_price: anyOf: - type: string - type: 'null' title: Product Price product_star_rating: anyOf: - type: string - type: 'null' title: Product Star Rating product_title: anyOf: - type: string - type: 'null' title: Product Title product_url: anyOf: - type: string - type: 'null' title: Product Url rank: anyOf: - type: integer - type: 'null' title: Rank rank_change_label: anyOf: - type: string - type: 'null' title: Rank Change Label title: BestSellerProduct type: object BestSellersData: additionalProperties: true properties: best_sellers: items: $ref: '#/components/schemas/BestSellerProduct' title: Best Sellers type: array country: title: Country type: string domain: title: Domain type: string required: - best_sellers - country - domain title: BestSellersData type: object BestSellersParameters: additionalProperties: true properties: category: title: Category type: string country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language page: title: Page type: integer type: title: Type type: string required: - country - type - page - category title: BestSellersParameters type: object BestSellersResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/BestSellersData' parameters: $ref: '#/components/schemas/BestSellersParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: BestSellersResponse type: object CategoryInfo: additionalProperties: true properties: id: title: Id type: string name: title: Name type: string required: - name - id title: CategoryInfo type: object CategoryPathItem: additionalProperties: true properties: id: title: Id type: string link: anyOf: - type: string - type: 'null' title: Link name: title: Name type: string required: - id - name title: CategoryPathItem type: object Deal: additionalProperties: true properties: canonical_deal_url: anyOf: - type: string - type: 'null' title: Canonical Deal Url deal_badge: anyOf: - type: string - type: 'null' title: Deal Badge deal_ends_at: anyOf: - type: string - type: 'null' title: Deal Ends At deal_id: anyOf: - type: string - type: 'null' title: Deal Id deal_photo: title: Deal Photo type: string deal_price: anyOf: - $ref: '#/components/schemas/DealPrice' - type: 'null' deal_starts_at: anyOf: - type: string - type: 'null' title: Deal Starts At deal_state: anyOf: - type: string - type: 'null' title: Deal State deal_title: title: Deal Title type: string deal_type: anyOf: - type: string - type: 'null' title: Deal Type deal_url: title: Deal Url type: string list_price: anyOf: - $ref: '#/components/schemas/DealPrice' - type: 'null' product_asin: title: Product Asin type: string savings_amount: anyOf: - $ref: '#/components/schemas/DealPrice' - type: 'null' savings_percentage: anyOf: - type: integer - type: 'null' title: Savings Percentage type: title: Type type: string required: - deal_title - deal_photo - deal_url - type - product_asin title: Deal type: object DealPrice: additionalProperties: true properties: amount: anyOf: - type: string - type: 'null' title: Amount currency: title: Currency type: string required: - currency title: DealPrice type: object DealProduct: additionalProperties: true properties: additional_info: anyOf: - items: type: string type: array - type: 'null' title: Additional Info deal_badge: anyOf: - type: string - type: 'null' title: Deal Badge deal_price: anyOf: - type: string - type: 'null' title: Deal Price list_price: anyOf: - type: string - type: 'null' title: List Price product_asin: title: Product Asin type: string product_photo: title: Product Photo type: string product_title: title: Product Title type: string product_url: title: Product Url type: string savings_percentage: anyOf: - type: string - type: 'null' title: Savings Percentage required: - product_asin - product_photo - product_title - product_url title: DealProduct type: object DealProductsData: additionalProperties: true properties: country: title: Country type: string domain: title: Domain type: string products: items: $ref: '#/components/schemas/DealProduct' title: Products type: array required: - products - country - domain title: DealProductsData type: object DealProductsParameters: additionalProperties: true properties: country: title: Country type: string deal_id: title: Deal Id type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language page: title: Page type: integer sort_by: title: Sort By type: string required: - country - deal_id - page - sort_by title: DealProductsParameters type: object DealProductsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/DealProductsData' parameters: $ref: '#/components/schemas/DealProductsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: DealProductsResponse type: object DealsData: additionalProperties: true properties: country: title: Country type: string deals: items: $ref: '#/components/schemas/Deal' title: Deals type: array domain: title: Domain type: string total_deals: anyOf: - type: integer - type: 'null' title: Total Deals required: - deals - country - domain title: DealsData type: object DealsParameters: additionalProperties: true properties: country: title: Country type: string discount_range: title: Discount Range type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language num_pages: title: Num Pages type: integer price_range: title: Price Range type: string required: - country - price_range - discount_range - num_pages title: DealsParameters type: object DealsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/DealsData' parameters: $ref: '#/components/schemas/DealsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: DealsResponse type: object ErrorEnvelope: additionalProperties: true properties: error: $ref: '#/components/schemas/ErrorObject' request_id: title: Request Id type: string status: enum: - error title: Status type: string required: - request_id - status - error title: ErrorEnvelope type: object ErrorObject: additionalProperties: true properties: code: title: Code type: string details: additionalProperties: true title: Details type: object message: title: Message type: string retryable: title: Retryable type: boolean required: - code - message - retryable title: ErrorObject type: object GtinResult: additionalProperties: true properties: type: title: Type type: string value: title: Value type: string required: - value - type title: GtinResult type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object InfluencerPostProduct: additionalProperties: true properties: asin: title: Asin type: string deal_badge_label: anyOf: - type: string - type: 'null' title: Deal Badge Label deal_badge_message: anyOf: - type: string - type: 'null' title: Deal Badge Message delivery_price: anyOf: - type: string - type: 'null' title: Delivery Price delivery_time: anyOf: - type: string - type: 'null' title: Delivery Time is_best_seller: title: Is Best Seller type: boolean product_brand: anyOf: - type: string - type: 'null' title: Product Brand product_price: anyOf: - type: string - type: 'null' title: Product Price product_title: title: Product Title type: string product_url: title: Product Url type: string required: - asin - product_title - product_url - is_best_seller title: InfluencerPostProduct type: object InfluencerPostProductsData: additionalProperties: true properties: country: title: Country type: string cursor: anyOf: - type: string - type: 'null' title: Cursor domain: title: Domain type: string has_next_page: title: Has Next Page type: boolean post_id: title: Post Id type: string products: items: $ref: '#/components/schemas/InfluencerPostProduct' title: Products type: array required: - post_id - country - domain - has_next_page - products title: InfluencerPostProductsData type: object InfluencerPostProductsParameters: additionalProperties: true properties: country: title: Country type: string cursor: anyOf: - type: string - type: 'null' title: Cursor influencer_name: anyOf: - type: string - type: 'null' title: Influencer Name language: anyOf: - type: string - type: 'null' title: Language post_id: title: Post Id type: string required: - post_id - country title: InfluencerPostProductsParameters type: object InfluencerPostProductsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/InfluencerPostProductsData' parameters: $ref: '#/components/schemas/InfluencerPostProductsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: InfluencerPostProductsResponse type: object InfluencerPostsData: additionalProperties: true properties: country: title: Country type: string cursor: anyOf: - type: string - type: 'null' title: Cursor domain: title: Domain type: string has_next_page: title: Has Next Page type: boolean name: title: Name type: string posts: items: $ref: '#/components/schemas/Post' title: Posts type: array required: - name - country - domain - has_next_page - posts title: InfluencerPostsData type: object InfluencerPostsParameters: additionalProperties: true properties: country: title: Country type: string cursor: anyOf: - type: string - type: 'null' title: Cursor fields: anyOf: - type: string - type: 'null' title: Fields influencer_name: title: Influencer Name type: string language: anyOf: - type: string - type: 'null' title: Language limit: title: Limit type: integer query: anyOf: - type: string - type: 'null' title: Query scope: title: Scope type: string required: - influencer_name - country - limit - scope title: InfluencerPostsParameters type: object InfluencerPostsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/InfluencerPostsData' parameters: $ref: '#/components/schemas/InfluencerPostsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: InfluencerPostsResponse type: object InfluencerProfileData: additionalProperties: true properties: affiliate_status: title: Affiliate Status type: string country: title: Country type: string domain: title: Domain type: string has_curations: title: Has Curations type: boolean is_top_creator: title: Is Top Creator type: boolean name: title: Name type: string posts_count: title: Posts Count type: integer profile_description: title: Profile Description type: string profile_link: title: Profile Link type: string required: - name - country - domain - profile_description - profile_link - is_top_creator - affiliate_status - has_curations - posts_count title: InfluencerProfileData type: object InfluencerProfileParameters: additionalProperties: true properties: country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields influencer_name: title: Influencer Name type: string language: anyOf: - type: string - type: 'null' title: Language required: - influencer_name - country title: InfluencerProfileParameters type: object InfluencerProfileResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/InfluencerProfileData' parameters: $ref: '#/components/schemas/InfluencerProfileParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: InfluencerProfileResponse type: object Lifetime: additionalProperties: true properties: count: title: Count type: integer negative_percent: title: Negative Percent type: integer neutral_percent: title: Neutral Percent type: integer positive_percent: title: Positive Percent type: integer required: - positive_percent - neutral_percent - negative_percent - count title: Lifetime type: object NinetyDays: additionalProperties: true properties: count: title: Count type: integer negative_percent: title: Negative Percent type: integer neutral_percent: title: Neutral Percent type: integer positive_percent: title: Positive Percent type: integer required: - positive_percent - neutral_percent - negative_percent - count title: NinetyDays type: object Offer: additionalProperties: true properties: currency: title: Currency type: string delivery_price: anyOf: - type: string - type: 'null' title: Delivery Price delivery_time: anyOf: - type: string - type: 'null' title: Delivery Time product_condition: title: Product Condition type: string product_condition_details: anyOf: - type: string - type: 'null' title: Product Condition Details product_original_price: anyOf: - type: string - type: 'null' title: Product Original Price product_price: title: Product Price type: string seller: title: Seller type: string seller_id: anyOf: - type: string - type: 'null' title: Seller Id seller_link: anyOf: - type: string - type: 'null' title: Seller Link seller_star_rating: anyOf: - type: string - type: 'null' title: Seller Star Rating seller_star_rating_info: anyOf: - type: string - type: 'null' title: Seller Star Rating Info ships_from: title: Ships From type: string required: - product_price - product_condition - ships_from - seller - currency title: Offer type: object Post: additionalProperties: true properties: is_pinned: title: Is Pinned type: boolean list_items_count: anyOf: - type: integer - type: 'null' title: List Items Count post_id: title: Post Id type: string post_thumbnail: title: Post Thumbnail type: string post_title: title: Post Title type: string post_type: title: Post Type type: string post_url: title: Post Url type: string video_duration: anyOf: - type: string - type: 'null' title: Video Duration required: - post_id - post_type - post_title - post_url - post_thumbnail - is_pinned title: Post type: object ProductCategoryListParameters: additionalProperties: true properties: country: title: Country type: string language: anyOf: - type: string - type: 'null' title: Language required: - country title: ProductCategoryListParameters type: object ProductCategoryListResponse: additionalProperties: true properties: data: items: $ref: '#/components/schemas/CategoryInfo' title: Data type: array parameters: $ref: '#/components/schemas/ProductCategoryListParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: ProductCategoryListResponse type: object ProductDetailsData: additionalProperties: true properties: about_product: items: type: string title: About Product type: array all_product_variations: additionalProperties: true title: All Product Variations type: object asin: title: Asin type: string category: $ref: '#/components/schemas/CategoryPathItem' category_path: items: $ref: '#/components/schemas/CategoryPathItem' title: Category Path type: array climate_pledge_friendly: title: Climate Pledge Friendly type: boolean country: title: Country type: string currency: title: Currency type: string customers_say: anyOf: - type: string - type: 'null' title: Customers Say delivery: anyOf: - type: string - type: 'null' title: Delivery has_aplus: title: Has Aplus type: boolean has_brandstory: title: Has Brandstory type: boolean has_video: title: Has Video type: boolean is_amazon_choice: title: Is Amazon Choice type: boolean is_best_seller: title: Is Best Seller type: boolean is_prime: title: Is Prime type: boolean landing_asin: title: Landing Asin type: string minimum_order_quantity: anyOf: - type: integer - type: 'null' title: Minimum Order Quantity parent_asin: title: Parent Asin type: string primary_delivery_time: anyOf: - type: string - type: 'null' title: Primary Delivery Time product_availability: anyOf: - type: string - type: 'null' title: Product Availability product_byline: anyOf: - type: string - type: 'null' title: Product Byline product_byline_link: anyOf: - type: string - type: 'null' title: Product Byline Link product_byline_links: items: type: string title: Product Byline Links type: array product_condition: anyOf: - type: string - type: 'null' title: Product Condition product_description: title: Product Description type: string product_details: additionalProperties: true title: Product Details type: object product_information: additionalProperties: true title: Product Information type: object product_num_offers: anyOf: - type: integer - type: 'null' title: Product Num Offers product_num_ratings: title: Product Num Ratings type: integer product_original_price: anyOf: - type: string - type: 'null' title: Product Original Price product_photo: title: Product Photo type: string product_photos: items: type: string title: Product Photos type: array product_price: anyOf: - type: string - type: 'null' title: Product Price product_slug: anyOf: - type: string - type: 'null' title: Product Slug product_star_rating: anyOf: - type: string - type: 'null' title: Product Star Rating product_title: title: Product Title type: string product_url: title: Product Url type: string product_variations: $ref: '#/components/schemas/ProductVariations' product_variations_dimensions: items: type: string title: Product Variations Dimensions type: array product_videos: items: {} title: Product Videos type: array rating_distribution: $ref: '#/components/schemas/RatingDistribution' sales_volume: anyOf: - type: string - type: 'null' title: Sales Volume top_reviews: items: $ref: '#/components/schemas/TopReview' title: Top Reviews type: array top_reviews_global: items: $ref: '#/components/schemas/TopReview' title: Top Reviews Global type: array user_uploaded_videos: items: {} title: User Uploaded Videos type: array required: - asin - product_title - currency - country - product_byline_links - product_num_ratings - product_url - product_photo - is_best_seller - is_amazon_choice - is_prime - climate_pledge_friendly - about_product - product_description - product_information - rating_distribution - product_photos - product_videos - user_uploaded_videos - has_video - product_details - top_reviews - top_reviews_global - category - category_path - product_variations_dimensions - product_variations - all_product_variations - has_aplus - has_brandstory - landing_asin - parent_asin title: ProductDetailsData type: object ProductDetailsParameters: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language more_info_query: anyOf: - type: string - type: 'null' title: More Info Query required: - asin - country title: ProductDetailsParameters type: object ProductDetailsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/ProductDetailsData' parameters: $ref: '#/components/schemas/ProductDetailsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: ProductDetailsResponse type: object ProductOffersData: additionalProperties: true properties: about_product: items: type: string title: About Product type: array all_product_variations: additionalProperties: true title: All Product Variations type: object asin: title: Asin type: string category: $ref: '#/components/schemas/CategoryPathItem' category_path: items: $ref: '#/components/schemas/CategoryPathItem' title: Category Path type: array climate_pledge_friendly: title: Climate Pledge Friendly type: boolean country: title: Country type: string currency: title: Currency type: string customers_say: anyOf: - type: string - type: 'null' title: Customers Say delivery: anyOf: - type: string - type: 'null' title: Delivery has_aplus: title: Has Aplus type: boolean has_brandstory: title: Has Brandstory type: boolean has_video: title: Has Video type: boolean is_amazon_choice: title: Is Amazon Choice type: boolean is_best_seller: title: Is Best Seller type: boolean is_prime: title: Is Prime type: boolean landing_asin: title: Landing Asin type: string minimum_order_quantity: anyOf: - type: integer - type: 'null' title: Minimum Order Quantity parent_asin: title: Parent Asin type: string primary_delivery_time: anyOf: - type: string - type: 'null' title: Primary Delivery Time product_availability: anyOf: - type: string - type: 'null' title: Product Availability product_byline: anyOf: - type: string - type: 'null' title: Product Byline product_byline_link: anyOf: - type: string - type: 'null' title: Product Byline Link product_byline_links: items: type: string title: Product Byline Links type: array product_condition: anyOf: - type: string - type: 'null' title: Product Condition product_description: title: Product Description type: string product_details: additionalProperties: true title: Product Details type: object product_information: additionalProperties: true title: Product Information type: object product_num_offers: anyOf: - type: integer - type: 'null' title: Product Num Offers product_num_ratings: title: Product Num Ratings type: integer product_offers: items: $ref: '#/components/schemas/Offer' title: Product Offers type: array product_original_price: anyOf: - type: string - type: 'null' title: Product Original Price product_photo: title: Product Photo type: string product_photos: items: type: string title: Product Photos type: array product_price: anyOf: - type: string - type: 'null' title: Product Price product_slug: anyOf: - type: string - type: 'null' title: Product Slug product_star_rating: anyOf: - type: string - type: 'null' title: Product Star Rating product_title: title: Product Title type: string product_url: title: Product Url type: string product_variations: $ref: '#/components/schemas/ProductVariations' product_variations_dimensions: items: type: string title: Product Variations Dimensions type: array product_videos: items: {} title: Product Videos type: array rating_distribution: $ref: '#/components/schemas/RatingDistribution' sales_volume: anyOf: - type: string - type: 'null' title: Sales Volume top_reviews: items: $ref: '#/components/schemas/TopReview' title: Top Reviews type: array top_reviews_global: items: $ref: '#/components/schemas/TopReview' title: Top Reviews Global type: array user_uploaded_videos: items: {} title: User Uploaded Videos type: array required: - asin - product_title - currency - country - product_byline_links - product_num_ratings - product_url - product_photo - is_best_seller - is_amazon_choice - is_prime - climate_pledge_friendly - about_product - product_description - product_information - rating_distribution - product_photos - product_videos - user_uploaded_videos - has_video - product_details - top_reviews - top_reviews_global - category - category_path - product_variations_dimensions - product_variations - all_product_variations - has_aplus - has_brandstory - landing_asin - parent_asin - product_offers title: ProductOffersData type: object ProductOffersParameters: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string delivery: anyOf: - type: string - type: 'null' title: Delivery exclude_fields: anyOf: - type: string - type: 'null' title: Exclude Fields field_preset: anyOf: - type: string - type: 'null' title: Field Preset fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language limit: anyOf: - type: integer - type: 'null' title: Limit mode: anyOf: - type: string - type: 'null' title: Mode page: anyOf: - type: integer - type: 'null' title: Page product_condition: anyOf: - type: string - type: 'null' title: Product Condition required: - asin - country title: ProductOffersParameters type: object ProductOffersResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/ProductOffersData' parameters: $ref: '#/components/schemas/ProductOffersParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: ProductOffersResponse type: object ProductReviewsData: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string domain: title: Domain type: string rating_distribution: $ref: '#/components/schemas/RatingDistribution' reviews: items: $ref: '#/components/schemas/TopReview' title: Reviews type: array total_ratings: title: Total Ratings type: integer required: - asin - country - domain - total_ratings - rating_distribution - reviews title: ProductReviewsData type: object ProductReviewsParameters: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string current_format_only: anyOf: - type: boolean - type: 'null' title: Current Format Only fields: anyOf: - type: string - type: 'null' title: Fields images_or_videos_only: anyOf: - type: boolean - type: 'null' title: Images Or Videos Only language: anyOf: - type: string - type: 'null' title: Language page: title: Page type: integer query: anyOf: - type: string - type: 'null' title: Query sort_by: title: Sort By type: string star_rating: title: Star Rating type: string verified_purchases_only: anyOf: - type: boolean - type: 'null' title: Verified Purchases Only required: - asin - country - sort_by - star_rating - page title: ProductReviewsParameters type: object ProductReviewsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/ProductReviewsData' parameters: $ref: '#/components/schemas/ProductReviewsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: ProductReviewsResponse type: object ProductVariations: additionalProperties: true properties: color: anyOf: - items: $ref: '#/components/schemas/VariationItem' type: array - type: 'null' title: Color service_provider: anyOf: - items: $ref: '#/components/schemas/VariationItem' type: array - type: 'null' title: Service Provider size: anyOf: - items: $ref: '#/components/schemas/VariationItem' type: array - type: 'null' title: Size style: anyOf: - items: $ref: '#/components/schemas/VariationItem' type: array - type: 'null' title: Style title: ProductVariations type: object PromoCodeData: additionalProperties: true properties: country: title: Country type: string discount_percentage: anyOf: - type: integer - type: 'null' title: Discount Percentage domain: title: Domain type: string is_promo_available: title: Is Promo Available type: boolean products: items: $ref: '#/components/schemas/PromoCodeProduct' title: Products type: array promo_title: title: Promo Title type: string required: - promo_title - is_promo_available - products - country - domain title: PromoCodeData type: object PromoCodeParameters: additionalProperties: true properties: country: title: Country type: string language: anyOf: - type: string - type: 'null' title: Language promo_code: title: Promo Code type: string required: - promo_code - country title: PromoCodeParameters type: object PromoCodeProduct: additionalProperties: true properties: asin: title: Asin type: string product_availability: anyOf: - type: string - type: 'null' title: Product Availability product_num_ratings: anyOf: - type: integer - type: 'null' title: Product Num Ratings product_photo: anyOf: - type: string - type: 'null' title: Product Photo product_price: anyOf: - type: string - type: 'null' title: Product Price product_star_rating: anyOf: - type: string - type: 'null' title: Product Star Rating product_title: title: Product Title type: string product_url: title: Product Url type: string required: - asin - product_title - product_url title: PromoCodeProduct type: object PromoCodeResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/PromoCodeData' parameters: $ref: '#/components/schemas/PromoCodeParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: PromoCodeResponse type: object RatingDistribution: additionalProperties: true properties: '1': title: '1' type: integer '2': title: '2' type: integer '3': title: '3' type: integer '4': title: '4' type: integer '5': title: '5' type: integer required: - '1' - '2' - '3' - '4' - '5' title: RatingDistribution type: object ReviewSummary: additionalProperties: true properties: lifetime: $ref: '#/components/schemas/Lifetime' ninety_days: $ref: '#/components/schemas/NinetyDays' thirty_days: $ref: '#/components/schemas/ThirtyDays' twelve_months: $ref: '#/components/schemas/TwelveMonths' required: - thirty_days - ninety_days - twelve_months - lifetime title: ReviewSummary type: object ReviewedProductVariant: additionalProperties: true properties: Color: anyOf: - type: string - type: 'null' title: Color Product_grade: anyOf: - type: string - type: 'null' title: Product Grade Service_provider: anyOf: - type: string - type: 'null' title: Service Provider Size: anyOf: - type: string - type: 'null' title: Size Style: anyOf: - type: string - type: 'null' title: Style title: ReviewedProductVariant type: object SearchData: additionalProperties: true properties: country: title: Country type: string domain: title: Domain type: string products: items: $ref: '#/components/schemas/SearchProduct' title: Products type: array total_products: title: Total Products type: integer required: - total_products - country - domain - products title: SearchData type: object SearchParameters: additionalProperties: true properties: additional_filters: anyOf: - type: string - type: 'null' title: Additional Filters brand: anyOf: - type: string - type: 'null' title: Brand category: anyOf: - type: string - type: 'null' title: Category category_id: anyOf: - type: string - type: 'null' title: Category Id country: title: Country type: string deals_and_discounts: anyOf: - type: string - type: 'null' title: Deals And Discounts fields: anyOf: - type: string - type: 'null' title: Fields four_stars_and_up: anyOf: - type: boolean - type: 'null' title: Four Stars And Up include_sponsored: anyOf: - type: boolean - type: 'null' title: Include Sponsored is_prime: anyOf: - type: boolean - type: 'null' title: Is Prime language: anyOf: - type: string - type: 'null' title: Language max_price: anyOf: - type: number - type: 'null' title: Max Price min_price: anyOf: - type: number - type: 'null' title: Min Price page: anyOf: - type: integer - type: 'null' title: Page product_condition: anyOf: - type: string - type: 'null' title: Product Condition query: anyOf: - type: string - type: 'null' title: Query seller_id: anyOf: - type: string - type: 'null' title: Seller Id sort_by: anyOf: - type: string - type: 'null' title: Sort By required: - country title: SearchParameters type: object SearchProduct: additionalProperties: true properties: asin: title: Asin type: string brand: anyOf: - type: string - type: 'null' title: Brand climate_pledge_friendly: anyOf: - type: boolean - type: 'null' title: Climate Pledge Friendly coupon_text: anyOf: - type: string - type: 'null' title: Coupon Text currency: anyOf: - type: string - type: 'null' title: Currency delivery: anyOf: - type: string - type: 'null' title: Delivery has_variations: anyOf: - type: boolean - type: 'null' title: Has Variations is_amazon_choice: anyOf: - type: boolean - type: 'null' title: Is Amazon Choice is_best_seller: anyOf: - type: boolean - type: 'null' title: Is Best Seller is_prime: anyOf: - type: boolean - type: 'null' title: Is Prime is_sponsored: anyOf: - type: boolean - type: 'null' title: Is Sponsored product_availability: anyOf: - type: string - type: 'null' title: Product Availability product_badge: anyOf: - type: string - type: 'null' title: Product Badge product_minimum_offer_price: anyOf: - type: string - type: 'null' title: Product Minimum Offer Price product_num_offers: anyOf: - type: integer - type: 'null' title: Product Num Offers product_num_ratings: anyOf: - type: integer - type: 'null' title: Product Num Ratings product_original_price: anyOf: - type: string - type: 'null' title: Product Original Price product_photo: anyOf: - type: string - type: 'null' title: Product Photo product_price: anyOf: - type: string - type: 'null' title: Product Price product_star_rating: anyOf: - type: string - type: 'null' title: Product Star Rating product_title: anyOf: - type: string - type: 'null' title: Product Title product_url: anyOf: - type: string - type: 'null' title: Product Url sales_volume: anyOf: - type: string - type: 'null' title: Sales Volume unit_count: anyOf: - type: integer - type: 'null' title: Unit Count unit_price: anyOf: - type: string - type: 'null' title: Unit Price required: - asin title: SearchProduct type: object SearchResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/SearchData' parameters: $ref: '#/components/schemas/SearchParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: SearchResponse type: object SellerProduct: additionalProperties: true properties: asin: title: Asin type: string brand: anyOf: - type: string - type: 'null' title: Brand climate_pledge_friendly: anyOf: - type: boolean - type: 'null' title: Climate Pledge Friendly coupon_text: anyOf: - type: string - type: 'null' title: Coupon Text currency: anyOf: - type: string - type: 'null' title: Currency delivery: anyOf: - type: string - type: 'null' title: Delivery has_variations: anyOf: - type: boolean - type: 'null' title: Has Variations is_amazon_choice: anyOf: - type: boolean - type: 'null' title: Is Amazon Choice is_best_seller: anyOf: - type: boolean - type: 'null' title: Is Best Seller is_prime: anyOf: - type: boolean - type: 'null' title: Is Prime is_sponsored: anyOf: - type: boolean - type: 'null' title: Is Sponsored product_availability: anyOf: - type: string - type: 'null' title: Product Availability product_badge: anyOf: - type: string - type: 'null' title: Product Badge product_minimum_offer_price: anyOf: - type: string - type: 'null' title: Product Minimum Offer Price product_num_offers: anyOf: - type: integer - type: 'null' title: Product Num Offers product_num_ratings: anyOf: - type: integer - type: 'null' title: Product Num Ratings product_original_price: anyOf: - type: string - type: 'null' title: Product Original Price product_photo: anyOf: - type: string - type: 'null' title: Product Photo product_price: anyOf: - type: string - type: 'null' title: Product Price product_star_rating: anyOf: - type: string - type: 'null' title: Product Star Rating product_title: anyOf: - type: string - type: 'null' title: Product Title product_url: anyOf: - type: string - type: 'null' title: Product Url sales_volume: anyOf: - type: string - type: 'null' title: Sales Volume unit_count: anyOf: - type: integer - type: 'null' title: Unit Count unit_price: anyOf: - type: string - type: 'null' title: Unit Price required: - asin title: SellerProduct type: object SellerProductsData: additionalProperties: true properties: country: title: Country type: string domain: title: Domain type: string seller_id: title: Seller Id type: string seller_products: items: $ref: '#/components/schemas/SellerProduct' title: Seller Products type: array total_products: title: Total Products type: integer required: - seller_id - total_products - country - domain - seller_products title: SellerProductsData type: object SellerProductsParameters: additionalProperties: true properties: country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language page: title: Page type: integer seller_id: title: Seller Id type: string sort_by: title: Sort By type: string required: - seller_id - country - page - sort_by title: SellerProductsParameters type: object SellerProductsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/SellerProductsData' parameters: $ref: '#/components/schemas/SellerProductsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: SellerProductsResponse type: object SellerProfileData: additionalProperties: true properties: business_address: title: Business Address type: string business_name: title: Business Name type: string country: title: Country type: string detailed_information: title: Detailed Information type: string domain: title: Domain type: string logo: title: Logo type: string name: title: Name type: string phone: title: Phone type: string rating: title: Rating type: number ratings_total: title: Ratings Total type: integer ratings_total_percentage: title: Ratings Total Percentage type: integer review_summary: $ref: '#/components/schemas/ReviewSummary' seller_id: title: Seller Id type: string seller_link: title: Seller Link type: string store_link: title: Store Link type: string required: - seller_id - country - domain - name - seller_link - store_link - logo - phone - business_name - business_address - detailed_information - rating - ratings_total - ratings_total_percentage - review_summary title: SellerProfileData type: object SellerProfileParameters: additionalProperties: true properties: country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language seller_id: title: Seller Id type: string required: - seller_id - country title: SellerProfileParameters type: object SellerProfileResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/SellerProfileData' parameters: $ref: '#/components/schemas/SellerProfileParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: SellerProfileResponse type: object SellerReview: additionalProperties: true properties: has_response: title: Has Response type: boolean review_author: title: Review Author type: string review_comment: title: Review Comment type: string review_date: title: Review Date type: string review_star_rating: title: Review Star Rating type: integer required: - review_author - review_comment - review_star_rating - has_response - review_date title: SellerReview type: object SellerReviewsData: additionalProperties: true properties: country: title: Country type: string domain: title: Domain type: string has_next_page: title: Has Next Page type: boolean seller_id: title: Seller Id type: string seller_reviews: items: $ref: '#/components/schemas/SellerReview' title: Seller Reviews type: array required: - seller_id - country - domain - has_next_page - seller_reviews title: SellerReviewsData type: object SellerReviewsParameters: additionalProperties: true properties: country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language page: title: Page type: integer seller_id: title: Seller Id type: string star_rating: title: Star Rating type: string required: - seller_id - country - page - star_rating title: SellerReviewsParameters type: object SellerReviewsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/SellerReviewsData' parameters: $ref: '#/components/schemas/SellerReviewsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: SellerReviewsResponse type: object ThirtyDays: additionalProperties: true properties: count: title: Count type: integer negative_percent: title: Negative Percent type: integer neutral_percent: title: Neutral Percent type: integer positive_percent: title: Positive Percent type: integer required: - positive_percent - neutral_percent - negative_percent - count title: ThirtyDays type: object TopProductReviewsData: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string domain: title: Domain type: string rating_distribution: $ref: '#/components/schemas/RatingDistribution' reviews: items: $ref: '#/components/schemas/TopReview' title: Reviews type: array required: - asin - country - domain - rating_distribution - reviews title: TopProductReviewsData type: object TopProductReviewsParameters: additionalProperties: true properties: asin: title: Asin type: string country: title: Country type: string fields: anyOf: - type: string - type: 'null' title: Fields language: anyOf: - type: string - type: 'null' title: Language required: - asin - country title: TopProductReviewsParameters type: object TopProductReviewsResponse: additionalProperties: true properties: data: $ref: '#/components/schemas/TopProductReviewsData' parameters: $ref: '#/components/schemas/TopProductReviewsParameters' request_id: title: Request Id type: string status: title: Status type: string required: - status - request_id - parameters - data title: TopProductReviewsResponse type: object TopReview: additionalProperties: true properties: helpful_vote_statement: anyOf: - type: string - type: 'null' title: Helpful Vote Statement is_verified_purchase: title: Is Verified Purchase type: boolean is_vine: title: Is Vine type: boolean review_author: title: Review Author type: string review_author_avatar: anyOf: - type: string - type: 'null' title: Review Author Avatar review_author_id: anyOf: - type: string - type: 'null' title: Review Author Id review_author_url: anyOf: - type: string - type: 'null' title: Review Author Url review_comment: title: Review Comment type: string review_date: title: Review Date type: string review_id: title: Review Id type: string review_images: items: type: string title: Review Images type: array review_link: title: Review Link type: string review_star_rating: title: Review Star Rating type: string review_title: title: Review Title type: string review_video: anyOf: - type: string - type: 'null' title: Review Video reviewed_product_asin: title: Reviewed Product Asin type: string reviewed_product_variant: anyOf: - $ref: '#/components/schemas/ReviewedProductVariant' - type: 'null' required: - review_id - review_title - review_comment - review_star_rating - review_link - review_author - review_images - review_date - is_verified_purchase - reviewed_product_asin - is_vine title: TopReview type: object TwelveMonths: additionalProperties: true properties: count: title: Count type: integer negative_percent: title: Negative Percent type: integer neutral_percent: title: Neutral Percent type: integer positive_percent: title: Positive Percent type: integer required: - positive_percent - neutral_percent - negative_percent - count title: TwelveMonths type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object VariationItem: additionalProperties: true properties: asin: title: Asin type: string is_available: title: Is Available type: boolean photo: anyOf: - type: string - type: 'null' title: Photo value: title: Value type: string required: - asin - value - is_available title: VariationItem type: object securitySchemes: InternalApiKeyAuth: description: Internal access key for direct usage. in: header name: x-api-key type: apiKey RapidAPIHostAuth: description: RapidAPI host header for marketplace routing. in: header name: X-RapidAPI-Host type: apiKey RapidAPIKeyAuth: description: RapidAPI subscription key. in: header name: X-RapidAPI-Key type: apiKey info: title: 'Azone: Real-Time Amazon Data API' version: 1.1.0 openapi: 3.1.0 paths: /: get: description: Root endpoint. operationId: root__get responses: '200': content: application/json: schema: {} description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. summary: Root /asin-to-gtin: get: description: Convert an Amazon ASIN to GTIN / EAN / UPS identifiers. operationId: asin_to_gtin_asin_to_gtin_get parameters: - description: Product ASIN to convert in: query name: asin required: true schema: description: Product ASIN to convert title: Asin type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country responses: '200': content: application/json: schema: $ref: '#/components/schemas/AsinToGtinResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Asin To Gtin /best-sellers: get: description: Get Amazon Best Sellers, including prices, ratings, rank and more data points. operationId: best_sellers_best_sellers_get parameters: - description: Best sellers category to return products for in: query name: category required: true schema: description: Best sellers category to return products for title: Category type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: 'Best Seller list type: BEST_SELLERS, NEW_RELEASES, MOVERS_AND_SHAKERS (or MOVERS_SHAKERS alias), MOST_WISHED_FOR, GIFT_IDEAS' in: query name: type required: false schema: anyOf: - type: string - type: 'null' default: BEST_SELLERS description: 'Best Seller list type: BEST_SELLERS, NEW_RELEASES, MOVERS_AND_SHAKERS (or MOVERS_SHAKERS alias), MOST_WISHED_FOR, GIFT_IDEAS' title: Type - description: Page number in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number title: Page - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/BestSellersResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Best Sellers /deal-products: get: description: Get the products of a specific deal by Deal ID. operationId: deal_products_deal_products_get parameters: - description: Deal ID to get products for in: query name: deal_id required: true schema: description: Deal ID to get products for title: Deal Id type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Sort order for products in: query name: sort_by required: false schema: anyOf: - type: string - type: 'null' default: FEATURED description: Sort order for products title: Sort By - description: Page number in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number title: Page - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/DealProductsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Deal Products /deals: get: description: Get Amazon Deals (Today's Deals / Top Deals, Best Deals, and Lightning Deals). operationId: deals_deals_get parameters: - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Number of results to skip for pagination in: query name: offset required: false schema: anyOf: - type: integer - type: 'null' default: 0 description: Number of results to skip for pagination title: Offset - description: Comma-separated list of category IDs in: query name: categories required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of category IDs title: Categories - description: Minimum product star rating in: query name: min_product_star_rating required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Minimum product star rating title: Min Product Star Rating - description: Price range filter in: query name: price_range required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Price range filter title: Price Range - description: Discount range filter in: query name: discount_range required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Discount range filter title: Discount Range - description: Comma-separated list of brands in: query name: brands required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of brands title: Brands - description: Filter for Prime Early Access deals in: query name: prime_early_access required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Filter for Prime Early Access deals title: Prime Early Access - description: Filter for Prime Exclusive deals in: query name: prime_exclusive required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Filter for Prime Exclusive deals title: Prime Exclusive - description: Filter for Lightning Deals in: query name: lightning_deals required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Filter for Lightning Deals title: Lightning Deals - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/DealsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Deals /endpoints: get: description: List all available endpoints. operationId: list_endpoints_endpoints_get responses: '200': content: application/json: schema: {} description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. summary: List Endpoints /health: get: description: Health check endpoint. operationId: health_check_health_get responses: '200': content: application/json: schema: {} description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. summary: Health Check /influencer-post-products: get: description: Get products from an influencer post. operationId: influencer_post_products_influencer_post_products_get parameters: - description: Influencer name or store page slug in: query name: influencer_name required: true schema: description: Influencer name or store page slug title: Influencer Name type: string - description: Influencer post ID in: query name: post_id required: true schema: description: Influencer post ID title: Post Id type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Cursor for pagination in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: Cursor for pagination title: Cursor - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language responses: '200': content: application/json: schema: $ref: '#/components/schemas/InfluencerPostProductsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Influencer Post Products /influencer-posts: get: description: Get influencer posts. operationId: influencer_posts_influencer_posts_get parameters: - description: Influencer name or store page slug in: query name: influencer_name required: true schema: description: Influencer name or store page slug title: Influencer Name type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Scope of posts to retrieve in: query name: scope required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Scope of posts to retrieve title: Scope - description: Find posts matching a search query in: query name: query required: false schema: anyOf: - type: string - type: 'null' description: Find posts matching a search query title: Query - description: Cursor for pagination in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: Cursor for pagination title: Cursor - description: Number of posts to return in: query name: limit required: false schema: anyOf: - maximum: 100 minimum: 1 type: integer - type: 'null' default: 20 description: Number of posts to return title: Limit - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/InfluencerPostsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Influencer Posts /influencer-profile: get: description: Get Amazon Influencer profile details from the Amazon Influencer store page. operationId: influencer_profile_influencer_profile_get parameters: - description: Influencer name or store page slug in: query name: influencer_name required: true schema: description: Influencer name or store page slug title: Influencer Name type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language responses: '200': content: application/json: schema: $ref: '#/components/schemas/InfluencerProfileResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Influencer Profile /product-by-category: get: description: Get products by browse node ID. operationId: product_by_category_product_by_category_get parameters: - description: Amazon browse node ID (numeric) in: query name: node_id required: true schema: description: Amazon browse node ID (numeric) title: Node Id type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Page number in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number title: Page - description: Sort order for products in: query name: sort_by required: false schema: anyOf: - type: string - type: 'null' default: RELEVANCE description: Sort order for products title: Sort By - description: Minimum price filter in: query name: min_price required: false schema: anyOf: - minimum: 0 type: number - type: 'null' description: Minimum price filter title: Min Price - description: Maximum price filter in: query name: max_price required: false schema: anyOf: - minimum: 0 type: number - type: 'null' description: Maximum price filter title: Max Price - description: Filter by product condition in: query name: product_condition required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Filter by product condition title: Product Condition - description: Filter by brand in: query name: brand required: false schema: anyOf: - type: string - type: 'null' description: Filter by brand title: Brand - description: Only return prime products in: query name: is_prime required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Only return prime products title: Is Prime - description: Include sponsored ads in results in: query name: include_sponsored required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Include sponsored ads in results title: Include Sponsored - description: Deals and discounts filter in: query name: deals_and_discounts required: false schema: anyOf: - type: string - type: 'null' default: NONE description: Deals and discounts filter title: Deals And Discounts - description: Return listings with ratings of 4 stars & up in: query name: four_stars_and_up required: false schema: anyOf: - type: boolean - type: 'null' description: Return listings with ratings of 4 stars & up title: Four Stars And Up - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/SearchResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Product By Category /product-category-list: get: description: Get Amazon product categories per country / Amazon domain. operationId: product_category_list_product_category_list_get parameters: - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProductCategoryListResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Product Category List /product-details: get: description: Get extensive Amazon product details and information available on the Amazon product page by asin. operationId: product_details_product_details_get parameters: - description: Product ASIN for which to get details. Supports batching of up to 10 ASINs in: query name: asin required: true schema: description: Product ASIN for which to get details. Supports batching of up to 10 ASINs title: Asin type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: A query to search and get more info about the product in: query name: more_info_query required: false schema: anyOf: - type: string - type: 'null' description: A query to search and get more info about the product title: More Info Query - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of product fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of product fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProductDetailsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Product Details /product-offers: get: description: Get all Amazon product details with an additional product_offers array containing product offers. operationId: product_offers_product_offers_get parameters: - description: Product ASIN for which to get offers in: query name: asin required: true schema: description: Product ASIN for which to get offers title: Asin type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Page number for offers pagination in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number for offers pagination title: Page - description: Number of offers per page in: query name: limit required: false schema: anyOf: - maximum: 100 minimum: 1 type: integer - type: 'null' default: 100 description: Number of offers per page title: Limit - description: Filter by product condition in: query name: product_condition required: false schema: anyOf: - type: string - type: 'null' default: NEW, USED_LIKE_NEW, USED_VERY_GOOD, USED_GOOD, USED_ACCEPTABLE description: Filter by product condition title: Product Condition - description: Filter by delivery option in: query name: delivery required: false schema: anyOf: - type: string - type: 'null' description: Filter by delivery option title: Delivery - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of product fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of product fields to include title: Fields - description: Comma separated list of product fields to exclude in: query name: exclude_fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of product fields to exclude title: Exclude Fields - description: offers_only (fast) or with_details (scrape product-details before offers) in: query name: mode required: false schema: anyOf: - type: string - type: 'null' default: offers_only description: offers_only (fast) or with_details (scrape product-details before offers) title: Mode - description: 'Optional field preset: compact or full' in: query name: field_preset required: false schema: anyOf: - type: string - type: 'null' description: 'Optional field preset: compact or full' title: Field Preset responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProductOffersResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Product Offers /product-reviews: get: description: Get Amazon product consumer reviews / sentiment. operationId: product_reviews_product_reviews_get parameters: - description: Product ASIN for which to get reviews in: query name: asin required: true schema: description: Product ASIN for which to get reviews title: Asin type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Page number (each page contains up to 10 reviews) in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number (each page contains up to 10 reviews) title: Page - description: Sort order for reviews in: query name: sort_by required: false schema: anyOf: - type: string - type: 'null' default: TOP_REVIEWS description: Sort order for reviews title: Sort By - description: Filter by star rating in: query name: star_rating required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Filter by star rating title: Star Rating - description: Filter verified purchases only in: query name: verified_purchases_only required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Filter verified purchases only title: Verified Purchases Only - description: Filter for reviews with images or videos in: query name: images_or_videos_only required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Filter for reviews with images or videos title: Images Or Videos Only - description: Filter for reviews of the current format in: query name: current_format_only required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Filter for reviews of the current format title: Current Format Only - description: Find reviews matching a search query in: query name: query required: false schema: anyOf: - type: string - type: 'null' description: Find reviews matching a search query title: Query - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of review fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of review fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProductReviewsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Product Reviews /promo-code-details: get: description: Get the products offered by an Amazon promo code. operationId: promo_code_details_promo_code_details_get parameters: - description: Promo code extracted from Amazon URL in: query name: promo_code required: true schema: description: Promo code extracted from Amazon URL title: Promo Code type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language responses: '200': content: application/json: schema: $ref: '#/components/schemas/PromoCodeResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Promo Code Details /search: get: description: Search for products & offers on Amazon with pagination support and multiple filters. operationId: search_products_search_get parameters: - description: Search query (supports both free-form text queries or a product asin) in: query name: query required: true schema: description: Search query (supports both free-form text queries or a product asin) title: Query type: string - description: Results page to return in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Results page to return title: Page - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Return the results in a specific sort order in: query name: sort_by required: false schema: anyOf: - type: string - type: 'null' default: RELEVANCE description: Return the results in a specific sort order title: Sort By - description: Find products in a specific category / department in: query name: category_id required: false schema: anyOf: - type: string - type: 'null' description: Find products in a specific category / department title: Category Id - description: Comma separated list of product fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of product fields to include title: Fields - description: Only return product offers with price greater than a certain value in: query name: min_price required: false schema: anyOf: - minimum: 0 type: number - type: 'null' description: Only return product offers with price greater than a certain value title: Min Price - description: Only return product offers with price lower than a certain value in: query name: max_price required: false schema: anyOf: - minimum: 0 type: number - type: 'null' description: Only return product offers with price lower than a certain value title: Max Price - description: Return products in a specific condition in: query name: product_condition required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Return products in a specific condition title: Product Condition - description: Find products with a specific brand in: query name: brand required: false schema: anyOf: - type: string - type: 'null' description: Find products with a specific brand title: Brand - description: Find products sold by a specific seller in: query name: seller_id required: false schema: anyOf: - type: string - type: 'null' description: Find products sold by a specific seller title: Seller Id - description: Filter by specific numeric Amazon category in: query name: category required: false schema: anyOf: - type: string - type: 'null' description: Filter by specific numeric Amazon category title: Category - description: Only return prime products in: query name: is_prime required: false schema: anyOf: - type: boolean - type: 'null' description: Only return prime products title: Is Prime - description: Include sponsored ads in results in: query name: include_sponsored required: false schema: anyOf: - type: boolean - type: 'null' default: false description: Include sponsored ads in results title: Include Sponsored - description: Return deals and discounts in a specific condition in: query name: deals_and_discounts required: false schema: anyOf: - type: string - type: 'null' default: NONE description: Return deals and discounts in a specific condition title: Deals And Discounts - description: Return product listings with ratings of 4 stars & up in: query name: four_stars_and_up required: false schema: anyOf: - type: boolean - type: 'null' description: Return product listings with ratings of 4 stars & up title: Four Stars And Up - description: Any filters available on the Amazon page but not part of this endpoint's parameters in: query name: additional_filters required: false schema: anyOf: - type: string - type: 'null' description: Any filters available on the Amazon page but not part of this endpoint's parameters title: Additional Filters - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language responses: '200': content: application/json: schema: $ref: '#/components/schemas/SearchResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Search Products /seller-products: get: description: Get products sold by a specific seller. operationId: seller_products_seller_products_get parameters: - description: Seller ID to get products for in: query name: seller_id required: true schema: description: Seller ID to get products for title: Seller Id type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Page number in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number title: Page - description: Sort order for products in: query name: sort_by required: false schema: anyOf: - type: string - type: 'null' default: RELEVANCE description: Sort order for products title: Sort By - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/SellerProductsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Seller Products /seller-profile: get: description: Get seller profile information. operationId: seller_profile_seller_profile_get parameters: - description: Seller ID to get profile for in: query name: seller_id required: true schema: description: Seller ID to get profile for title: Seller Id type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/SellerProfileResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Seller Profile /seller-reviews: get: description: Get seller reviews. operationId: seller_reviews_seller_reviews_get parameters: - description: Seller ID to get reviews for in: query name: seller_id required: true schema: description: Seller ID to get reviews for title: Seller Id type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: Page number in: query name: page required: false schema: anyOf: - minimum: 1 type: integer - type: 'null' default: 1 description: Page number title: Page - description: Filter by star rating in: query name: star_rating required: false schema: anyOf: - type: string - type: 'null' default: ALL description: Filter by star rating title: Star Rating - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/SellerReviewsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Seller Reviews /top-product-reviews: get: description: Get top product reviews. operationId: top_product_reviews_top_product_reviews_get parameters: - description: Product ASIN for which to get top reviews in: query name: asin required: true schema: description: Product ASIN for which to get top reviews title: Asin type: string - description: Sets the Amazon domain, marketplace country, language and currency in: query name: country required: false schema: anyOf: - type: string - type: 'null' default: US description: Sets the Amazon domain, marketplace country, language and currency title: Country - description: The language of the results in: query name: language required: false schema: anyOf: - type: string - type: 'null' default: en_US description: The language of the results title: Language - description: Comma separated list of fields to include in: query name: fields required: false schema: anyOf: - type: string - type: 'null' description: Comma separated list of fields to include title: Fields responses: '200': content: application/json: schema: $ref: '#/components/schemas/TopProductReviewsResponse' description: Successful Response '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Invalid request. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Authentication required. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Access forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Resource not found. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limit exceeded. headers: Retry-After: description: Seconds the client should wait before retrying. schema: type: integer '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. '502': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream bad response. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream temporarily unavailable. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Upstream timeout. security: - InternalApiKeyAuth: [] - RapidAPIHostAuth: [] RapidAPIKeyAuth: [] summary: Top Product Reviews