---
title: "Amazon product or search results"
method: POST
path: "/v1/amazon"
tags: ["API"]
---

# Amazon product or search results

`POST /v1/amazon`

## Request

- Base URL: `https://api.fastaf.co`
- URL: `https://api.fastaf.co/v1/amazon`
- Auth: HTTP bearer

## Request body

- union
  - object
    - `resource` 'search' | 'product' | 'offers' | 'bestsellers': Resource type. Defaults to search.
    - `asin` string: Required for the product and offers resources.
    - `query` string, required: Required for the search resource.
    - `domain` string: FastAF domain parameter.
    - `country` string: FastAF country parameter.
    - `language` string: FastAF language parameter.
    - `postal_code` string: FastAF postal_code parameter.
    - `page` integer: FastAF page parameter.
    - `premium` boolean: FastAF premium parameter.
    - `sort_by` 'helpful' | 'recent': FastAF sort_by parameter.
    - `filter_by_star` 'all_stars' | 'five_star' | 'four_star' | 'three_star' | 'two_star' | 'one_star' | 'positive' | 'critical': FastAF filter_by_star parameter.
    - `reviewer_type` 'all_reviews' | 'avp_only_reviews': FastAF reviewer_type parameter.
    - `media_type` 'all_contents' | 'media_reviews_only': FastAF media_type parameter.
    - `format_type` 'all_formats' | 'current_format': FastAF format_type parameter.
    - `url` string: FastAF url parameter.
    - `category_id` string: FastAF category_id parameter.
    - `type` 'bestsellers' | 'new_releases' | 'movers_and_shakers' | 'most_wished_for' | 'most_gifted': FastAF type parameter.
    - `full_list` boolean: FastAF full_list parameter.
  - object
    - `resource` 'product', required: Resource type. Defaults to search.
    - `asin` string, required: Required for the product and offers resources.
    - `query` string: Required for the search resource.
    - `domain` string: FastAF domain parameter.
    - `country` string: FastAF country parameter.
    - `language` string: FastAF language parameter.
    - `postal_code` string: FastAF postal_code parameter.
    - `page` integer: FastAF page parameter.
    - `premium` boolean: FastAF premium parameter.
    - `sort_by` 'helpful' | 'recent': FastAF sort_by parameter.
    - `filter_by_star` 'all_stars' | 'five_star' | 'four_star' | 'three_star' | 'two_star' | 'one_star' | 'positive' | 'critical': FastAF filter_by_star parameter.
    - `reviewer_type` 'all_reviews' | 'avp_only_reviews': FastAF reviewer_type parameter.
    - `media_type` 'all_contents' | 'media_reviews_only': FastAF media_type parameter.
    - `format_type` 'all_formats' | 'current_format': FastAF format_type parameter.
    - `url` string: FastAF url parameter.
    - `category_id` string: FastAF category_id parameter.
    - `type` 'bestsellers' | 'new_releases' | 'movers_and_shakers' | 'most_wished_for' | 'most_gifted': FastAF type parameter.
    - `full_list` boolean: FastAF full_list parameter.
  - object
    - `resource` 'offers', required: Resource type. Defaults to search.
    - `asin` string, required: Required for the product and offers resources.
    - `query` string: Required for the search resource.
    - `domain` string: FastAF domain parameter.
    - `country` string: FastAF country parameter.
    - `language` string: FastAF language parameter.
    - `postal_code` string: FastAF postal_code parameter.
    - `page` integer: FastAF page parameter.
    - `premium` boolean: FastAF premium parameter.
    - `sort_by` 'helpful' | 'recent': FastAF sort_by parameter.
    - `filter_by_star` 'all_stars' | 'five_star' | 'four_star' | 'three_star' | 'two_star' | 'one_star' | 'positive' | 'critical': FastAF filter_by_star parameter.
    - `reviewer_type` 'all_reviews' | 'avp_only_reviews': FastAF reviewer_type parameter.
    - `media_type` 'all_contents' | 'media_reviews_only': FastAF media_type parameter.
    - `format_type` 'all_formats' | 'current_format': FastAF format_type parameter.
    - `url` string: FastAF url parameter.
    - `category_id` string: FastAF category_id parameter.
    - `type` 'bestsellers' | 'new_releases' | 'movers_and_shakers' | 'most_wished_for' | 'most_gifted': FastAF type parameter.
    - `full_list` boolean: FastAF full_list parameter.
  - object
    - `resource` 'bestsellers', required: Resource type. Defaults to search.
    - `asin` string: Required for the product and offers resources.
    - `query` string: Required for the search resource.
    - `domain` string: FastAF domain parameter.
    - `country` string: FastAF country parameter.
    - `language` string: FastAF language parameter.
    - `postal_code` string: FastAF postal_code parameter.
    - `page` integer: FastAF page parameter.
    - `premium` boolean: FastAF premium parameter.
    - `sort_by` 'helpful' | 'recent': FastAF sort_by parameter.
    - `filter_by_star` 'all_stars' | 'five_star' | 'four_star' | 'three_star' | 'two_star' | 'one_star' | 'positive' | 'critical': FastAF filter_by_star parameter.
    - `reviewer_type` 'all_reviews' | 'avp_only_reviews': FastAF reviewer_type parameter.
    - `media_type` 'all_contents' | 'media_reviews_only': FastAF media_type parameter.
    - `format_type` 'all_formats' | 'current_format': FastAF format_type parameter.
    - `url` string: FastAF url parameter.
    - `category_id` string: FastAF category_id parameter.
    - `type` 'bestsellers' | 'new_releases' | 'movers_and_shakers' | 'most_wished_for' | 'most_gifted': FastAF type parameter.
    - `full_list` boolean: FastAF full_list parameter.

## Response `200`

Provider response.

## Other responses

- `400`: Invalid request or parameters.
- `401`: A valid bearer API key is required.
- `402`: The account has insufficient credits.
- `403`: The account is suspended.
- `429`: A rate or concurrency limit was reached.
- `502`: The upstream request failed.
- `503`: The service is temporarily unavailable.
- `504`: The upstream request timed out.

---

[API](https://skmtc.dev/fastaf/apis/fastaf-api.md) · [All operations](https://skmtc.dev/fastaf/apis/fastaf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fastaf/apis/fastaf-api/revisions/5917bde2f4e0?raw)