Amazon Türkiye API

HealthyRead-only

Search, browse best sellers and fetch product details (price, availability, ratings, specs) and customer reviews from Amazon Türkiye (amazon.com.tr). Generated from www.amazon.com.tr.

Docs Get API key

Base URL

https://api.maviapi.com/v1/sites/amazon-com-tr

Version

Endpoints

1957ms

p50 latency

Calls / 30d

GET/search

Search products

Search Amazon Türkiye products by keyword with category, price-range and sort filters. Returns title, price (TRY), list price, rating, rating count, image, delivery and a sponsored flag per result. ?page walks the site's result pages (about 24-60 per page).

Bearer auth. Pass your key as Authorization: Bearer <key> on every request.

Parameters

q

stringRequiredin query

Search text

category

stringOptionalin query

Department (search alias); aps = all

sort

stringOptionalin query

Sort order

min_price

numberOptionalin query

Minimum price in TRY

max_price

numberOptionalin query

Maximum price in TRY

page

integerOptionalin query

Result page on the site

limit

integerOptionalin query

Page size (items returned from the cached result)

offset

integerOptionalin query

Items to skip

refresh

booleanOptionalin query

Bypass and repopulate the cache

Response fields

dataobject

cachedboolean

sourcestring

paginationobject

Try itLive

GET

https://api.maviapi.com/v1/sites/amazon-com-tr/search?q=kulakl%C4%B1k&category=electronics&sort=relevance&min_price=500&max_price=3000&page=1&limit=10&offset=0&refresh=false

Request

1
2

curl "https://api.maviapi.com/v1/sites/amazon-com-tr/search?q=kulakl%C4%B1k&category=electronics&sort=relevance&min_price=500&max_price=3000&page=1&limit=10&offset=0&refresh=false" \
  -H "Authorization: Bearer $MAVI_KEY"

Example1.1 KB

{
  "data": {
    "query": "kulaklık",
    "category": "aps",
    "sort": "relevance",
    "page": 1,
    "total_results_text": "6.000 üzeri sonuç arasından 1-48 arası gösteriliyor. Aranan ürün: \"kulaklık\"",
    "total_results": 6000,
    "has_next_page": true,
    "count": 48,
    "products": [
      {
        "position": 1,
        "asin": "B0CDMB5ZQW",
        "title": "HUAWEI FreeBuds SE 2, 40 Saatlik Pil Ömrü, Beyaz",
        "url": "https://www.amazon.com.tr/dp/B0CDMB5ZQW",
        "image": "https://m.media-amazon.com/images/I/51VRW+4dYgL._AC_UL320_.jpg",
        "price": 1414.7,
        "list_price": 1599,
        "currency": "TRY",
        "rating": 4.5,
        "rating_count": 13463,
        "bought_past_month": "Geçen ay 500 adetten fazla satın alındı",
        "delivery": "ÜCRETSİZ teslimat 14 Kas Cmt veya en hızlı teslimat 12 Kas Per",
        "sponsored": false
      }
    ]
  },
  "cached": false,
  "source": "amazon.com.tr",
  "pagination": {
    "total": 48,
    "limit": 50,
    "offset": 0,
    "count": 48,
    "has_more": false
  }
}

Get all the data, no code

Collect every page of GET /search into a dataset, then download it as CSV or JSON. One credit per page; the download is free.

Use Amazon Türkiye API from Claude, Cursor and other AI agents

The maviapi MCP server exposes every endpoint of this API as a typed tool. Works with no key on the shared demo limits.

Other clients

claude mcp add maviapi -e MAVIAPI_TOOLS=amazon-com-tr -- npx -y '@maviapi/mcp'

Build with the Amazon Türkiye API

Start with the operation and schema your application needs. This reference is generated from the currently published build, so its parameters and fields describe the API you can call. Use the console to inspect a response before adding it to a production workflow. The examples illustrate the response shape; they are not a promise that a particular record or value will still exist when you make a request.

For a dashboard or internal tool, fetch the specific data your screen needs and handle empty results explicitly. For a recurring collection, check whether the selected endpoint returns a paginated collection and supports saving to a dataset. A dataset can be exported as CSV or JSON and refreshed on a schedule. Review current plans and credit limits before running a large collection; a single export can require more than one API request.

Choose a starting endpoint

GET /search

Parameters and response fields for GET /search

Request parameters
Name	Type / location	Required	Description
q	string / query	Yes	Search text
category	string / query	No	Department (search alias); aps = all Allowed values: aps, electronics, computers, home, kitchen, garden, baby, pets, grocery, stripbooks, beauty, fashion, mi, office-products, automotive, toys, videogames, hpc, sports, diy, warehouse-deals.
sort	string / query	No	Sort order Allowed values: relevance, price-asc, price-desc, rating, newest, bestsellers.
min_price	number / query	No	Minimum price in TRY
max_price	number / query	No	Maximum price in TRY
page	integer / query	No	Result page on the site
limit	integer / query	No	Page size (items returned from the cached result)
offset	integer / query	No	Items to skip
refresh	boolean / query	No	Bypass and repopulate the cache

Top-level response fields
Field	Type	Description
data	object
cached	boolean
source	string
pagination	object

GET /products/{asin}
Full detail for one product: title, brand or authors, price and list price (TRY), discount, availability, rating and star histogram, seller, shipper, best-seller rank, delivery, categories, feature bullets, description, specs and images.
Parameters and response fields for GET /products/{asin}
Request parameters
Name Type / location Required Description
asin string / path Yes Amazon product id (ASIN, 10 characters; ISBN-10 for books)
refresh boolean / query No Bypass and repopulate the cache
Top-level response fields
Field Type Description
data object
cached boolean
source string

GET /explore

One call for product discovery: kind=search (q, with the search filters) or kind=bestsellers (category) returns the list plus full product detail, optionally with top reviews, for the top N items. Sponsored results are left out of the search flow.

Parameters and response fields for GET /explore

Request parameters
Name	Type / location	Required	Description
kind	string / query	No	Which list to start from Allowed values: search, bestsellers.
q	string / query	No	Search text (kind=search)
category	string / query	No	Search department (kind=search) or best-seller department (kind=bestsellers) Allowed values: aps, electronics, computers, home, kitchen, garden, baby, pets, grocery, stripbooks, beauty, fashion, mi, office-products, automotive, toys, videogames, hpc, sports, diy, warehouse-deals, home-improvement, apparel, baby-products, books, sporting-goods, pet-supplies, musical-instruments, gift-cards.
sort	string / query	No	Sort order (kind=search) Allowed values: relevance, price-asc, price-desc, rating, newest, bestsellers.
page	integer / query	No	Source page
details	integer / query	No	How many top items get full product detail Allowed values: 0, 1, 2, 3, 4, 5.
reviews	boolean / query	No	Include up to 10 top reviews in each detail
limit	integer / query	No	Page size (items returned from the cached result)
offset	integer / query	No	Items to skip
refresh	boolean / query	No	Bypass and repopulate the cache

Top-level response fields
Field	Type	Description
data	object
cached	boolean
source	string
pagination	object

GET /products/{asin}/reviews

Top customer reviews shown on the product page (Turkish reviews first, then top reviews from other Amazon countries): title, rating, author, date, country, verified purchase, variant, text and helpful votes. Amazon shows about 10-15 reviews per product without sign-in.

Parameters and response fields for GET /products/{asin}/reviews

Request parameters
Name	Type / location	Required	Description
asin	string / path	Yes	Amazon product id (ASIN, 10 characters; ISBN-10 for books)
limit	integer / query	No	Page size (items returned from the cached result)
offset	integer / query	No	Items to skip
refresh	boolean / query	No	Bypass and repopulate the cache

Top-level response fields
Field	Type	Description
data	object
cached	boolean
source	string
pagination	object

GET /bestsellers

Ranked best sellers for a department. page=1 is ranks 1-50, page=2 ranks 51-100; the first ~30 of each page carry full fields, the rest rank + ASIN (fetch /products/{asin} for those).

Parameters and response fields for GET /bestsellers

Request parameters
Name	Type / location	Required	Description
category	string / query	No	Department Allowed values: electronics, computers, home, kitchen, home-improvement, garden, beauty, hpc, apparel, baby-products, books, toys, videogames, sporting-goods, automotive, office-products, pet-supplies, grocery, musical-instruments, gift-cards.
page	integer / query	No	1 = ranks 1-50, 2 = ranks 51-100 Allowed values: 1, 2.
limit	integer / query	No	Page size (items returned from the cached result)
offset	integer / query	No	Items to skip
refresh	boolean / query	No	Bypass and repopulate the cache

Top-level response fields
Field	Type	Description
data	object
cached	boolean
source	string
pagination	object

Integration questions

Is this the official Amazon Türkiye API?

This is an independent API hosted by maviapi for data from https://www.amazon.com.tr. Its available operations are the endpoints in this reference. It does not imply a partnership with the source website or access to that website's private data. Check the source's own developer documentation separately if you need its official API or a feature outside this schema.

What can I do with this Amazon Türkiye integration?

Search, browse best sellers and fetch product details (price, availability, ratings, specs) and customer reviews from Amazon Türkiye (amazon.com.tr). The current reference contains 5 endpoints. All published endpoints use GET, so this build is for reading data, not changing the source website. Choose the operation that matches your workflow, then inspect its required parameters and response fields. Do not assume an unlisted operation is supported.

How do I authenticate and try a request?

Create a maviapi API key in the dashboard and send it in the Authorization header as Bearer followed by your key. The interactive console above provides parameter forms and cURL, Node.js and Python examples for the selected endpoint. Replace example values with inputs for your task. Keep your key in server-side environment variables; do not put it in a public repository or a browser bundle.

What happens when the source website changes?

maviapi checks endpoint health and attempts repairs when it detects failures. A repair must pass verification before becoming active. This reduces manual scraper maintenance, but does not guarantee that every source is reachable at every moment. Check the status page for current health and this API’s changelog for build history. Handle failed requests in your application and retry with a bounded backoff rather than an unbounded loop.

How do I keep my integration compatible?

Use the published input and output schema as the contract for the build you call. Required parameters, field types and available operations can differ between builds, so review the changelog before adopting a new version. Where you need stable behavior, configure a build pin for your API key. Include validation and error handling at your application boundary instead of assuming example response values will always be present.

Integration documentation Build changelog Current endpoint health Dataset guide

Hepsiburada
Product search listings from Hepsiburada (hepsiburada.com) — product name, brand, price, rating, and seller (merchant) for a search query.

Browse the full API catalog

Amazon Türkiye API

Search products

Parameters

Response fields

Get all the data, no code

Use Amazon Türkiye API from Claude, Cursor and other AI agents

Build with the Amazon Türkiye API

Choose a starting endpoint

Integration questions

Is this the official Amazon Türkiye API?

What can I do with this Amazon Türkiye integration?

How do I authenticate and try a request?

What happens when the source website changes?

How do I keep my integration compatible?

Explore more shopping APIs