Vatan Bilgisayar API & Scraper
The Vatan Bilgisayar API returns Türkiye's electronics retailer as clean JSON, in five actions: search, product/detail, product/stores, search/suggest and deals.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
A search row carries the product's URL slug and Vatan product code, title, images, the online price in TRY, the Web'e Özel price and the regular price it undercuts, the struck-through price with its discount, the basket-only 'sepette' price as its own field, the card's rating, colour options and deal notes. search browses a keyword or a category, filters by brand, price range and in-stock, offers the seven orderings the site offers, follows the keywords Vatan redirects to a category with the filters kept, and returns the categories, brands and price bands available. product/detail adds the MPN, colour, interest-free instalments, availability including 'out of stock online' and pre-order, free shipping, the exact rating and review count, the image gallery, the breadcrumb, the full specification table, the description and the colour and capacity variants with their ids. product/stores lists every Vatan store holding the product with city, address, phone, coordinates, opening hours and the stock number Vatan publishes. deals returns the Fırsat, Web'e Özel and Outlet lists. Measured on 2026-09-15: 51 of 51 live cases behaved as expected, with 29 of 29 filter, paging, price and redirect checks. Across 594 search rows from 28 listings, title, price and product code were filled on 594 of 594. On seven products the title, price, availability, rating and review count were compared with the product page itself: 7 of 7 matched on every field. In a 73-call reliability run, 73 of 73 succeeded. No Vatan account, no browser. One ReefAPI key and the standard { ok, data, meta, error } envelope.
Which Vatan price is which
A Vatan product can show up to four numbers at once. They mean different things, so the engine returns them as different fields and never folds a basket-only offer into the price.
| Field | What it is | Measured on 2026-09-15 |
|---|---|---|
| price | The price an online buyer pays: the Web'e Özel price when one applies, otherwise the product price | 594 of 594 search rows; equal to the product page's own structured-data price on 6 of 6 products that publish one |
| regular_price, price_label | On a Web'e Özel product, the larger price shown above the web price | 64 of 594 search rows; a robot vacuum at 64,799 TL web price against 64,999 TL |
| was_price, discount_percent | The struck-through price, only when Vatan shows one | 25 of 594 search rows |
| basket_price, basket_price_label | A 'Sepette' price applied only in the basket, such as a night-only offer. Never written into price | 80 of 594 search rows; a robot vacuum at 48,999 TL with 47,448 TL in the basket |
| rating_rounded (search) / rating (detail) | The card shows the rating rounded to one decimal; the product record carries the exact rating and review count | A product rated 4.75 from 4 reviews shows 4.8 on its card |
| installment | 'Peşin Fiyatına N Taksit', an interest-free split of the same price | 24 of 25 measured product records |
| availability | in_stock, out_of_stock_online (the buy button is replaced by the store-stock button) or pre_order | All three seen live; product/stores still lists store stock for an item that is out of stock online |
The 'X TL'den başlayan taksitlerle' line on a product page is usually a monthly amount, but on an iPhone 15 it equals the basket price, so the engine returns it as installment_teaser_amount and never calls it a monthly figure.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/vatan/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "kulaklık"
}
}{
"ok": true,
"meta": {
"api": "vatan",
"endpoint": "search",
"mode": "live",
"latency_ms": 2057.8,
"record_count": 24,
"bytes": 310327,
"cache_hit": false,
"pagination": {
"page": 1,
"has_more": true,
"total": 651
}
},
"data": {
"results": [
{
"position": 1,
"slug": "apple-earbuds-kulaklik.html",
"product_code": "MWTY3TU/A",
"title": "Apple MWTY3TU/A Lightning Konnektörlü Earpods Kulaklık",
"url": "https://www.vatanbilgisayar.com/apple-earbuds-kulaklik.html",
"image": "https://cdn.vatanbilgisayar.com/Upload/PRODUCT/apple/thumb/148430-1_small.jpg",
"images": [
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/apple/thumb/148430-1_small.jpg",
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/apple/thumb/148430-2_small.jpg",
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/apple/thumb/148430-3_small.jpg"
],
"price": 1149,
"currency": "TRY",
"regular_price": null,
"price_label": null,
"price_note": null,
"was_price": null,
"discount_percent": null,
"discount_amount": null,
"basket_price": null,
"basket_price_label": null,
"rating_rounded": 5,
"lowest_price_note": null,
"web_exclusive_badge": null,
"color_options": null,
"color_options_out_of_stock": null,
"is_outlet": null,
"badge_images": [
"https://cdn.vatanbilgisayar.com/Upload/general//badge/paraf-ile-pesin-fiyatiana-6taksit-17-7-26.png"
]
},
{
"position": 2,
"slug": "jbl-tune-520bt-multi-connect-wireless-kulaklik-siyah.html",
"product_code": "JB.JBLT520BTBLKEU",
"title": "JBL Tune 520bt Multi Connect Kablosuz Kulak Üstü Kulaklık - Siyah",
"url": "https://www.vatanbilgisayar.com/jbl-tune-520bt-multi-connect-wireless-kulaklik-siyah.html",
"image": "https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/139118-1_small.jpg",
"images": [
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/139118-1_small.jpg",
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/139118-2_small.jpg"
],
"price": 2189,
"currency": "TRY",
"regular_price": null,
"price_label": null,
"price_note": null,
"was_price": null,
"discount_percent": null,
"discount_amount": null,
"basket_price": null,
"basket_price_label": null,
"rating_rounded": 4.7,
"lowest_price_note": null,
"web_exclusive_badge": true,
"color_options": null,
"color_options_out_of_stock": null,
"is_outlet": null,
"badge_images": []
},
{
"position": 3,
"slug": "jbl-c100si-mikrofonlu-kablolu-kulakici-kulaklik-siyah.html",
"product_code": "JB.JBLC100SIUBLKE",
"title": "JBL C100SI Mikrofonlu Kablolu Kulak İçi Kulaklık - Siyah",
"url": "https://www.vatanbilgisayar.com/jbl-c100si-mikrofonlu-kablolu-kulakici-kulaklik-siyah.html",
"image": "https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/152188-1_small.jpg",
"images": [
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/152188-1_small.jpg",
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/152188-2_small.jpg",
"https://cdn.vatanbilgisayar.com/Upload/PRODUCT/jbl/thumb/152188-3_small.jpg"
],
"price": 579,
"currency": "TRY",
"regular_price": null,
"price_label": null,
"price_note": null,
"was_price": null,
"discount_percent": null,
"discount_amount": null,
"basket_price": null,
"basket_price_label": null,
"rating_rounded": null,
"lowest_price_note": null,
"web_exclusive_badge": null,
"color_options": null,
"color_options_out_of_stock": null,
"is_outlet": null,
"badge_images": []
}
],
"count": 24,
"page": 1,
"page_size": 24,
"total_results": 651,
"total_pages": 28,
"page_notice": null,
"sort": "relevance",
"filters": {
"categories": [
{
"name": "Bağlantı Cihazları ve Çeviriciler",
"path": "/arama/kulakl%C4%B1k/baglanti-cihazlari-ve-ceviriciler/",
"count": 2
},
{
"name": "Çantalar ve Kılıflar",
"path": "/arama/kulakl%C4%B1k/cantalar-kiliflar/",
"count": 13
},
{
"name": "Dj Ekipmanları",
"path": "/arama/kulakl%C4%B1k/dj-ekipmanlari/",
"count": 2
}
],
"brands": [
{
"name": "ADDISON",
"brand": "addison",
"path": "/arama/kulakl%C4%B1k/addison/",
"count": 2
},
{
"name": "ANKER",
"brand": "anker",
"path": "/arama/kulakl%C4%B1k/anker/",
"count": 62
},
{
"name": "APPLE",
"brand": "apple",
"path": "/arama/kulakl%C4%B1k/apple/",
"count": 16
}
],
"price_bands": [
{
"label": "200 - 499TL",
"path": "/arama/kulakl%C4%B1k/200-500-tl-arasi/",
"count": 22
},
{
"label": "500 - 999 TL",
"path": "/arama/kulakl%C4%B1k/500-1000-tl-arasi/",
"count": 51
},
{
"label": "1000 - 1999 TL",
"path": "/arama/kulakl%C4%B1k/1000-2000-tl-arasi/",
"count": 136
}
]
},
"query": "kulaklık",
"category": null,
"brand": null,
"in_stock_only": false,
"redirected_to": null,
"fallback_results_dropped": 0,
"keyword_matches_on_page": 23
}
}What the Vatan Bilgisayar API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search vatanbilgisayar.com by keyword or browse a category, 24 products per page: slug, product code, title, images, the online price in TRY with the struck price, the Web'e Özel price and the basket-only ('sepette') price kept apart, the card's rating, colour options and deal notes. Filter by brand, price range and in-stock, sort the way the site does, page through results. Keywords Vatan redirects to a category are followed with the filters kept. The response lists the categories, brands and price bands available. | Pricing teams call search to search vatanbilgisayar.com by keyword or browse a category, 24 products per page. | query, category, brand, page, sort, ... |
| product/detail | The full Vatan product record by numeric id, URL or slug: title, brand, product code and MPN, online price in TRY with the Web'e Özel, struck and basket-only prices kept apart, interest-free instalments, availability (including 'out of stock online'), free shipping, rating and review count, image gallery, breadcrumb, key attributes and the full specification table, description, colour/capacity variants with their ids, and the page's review sample. | Marketplace operators call product/detail to get the full Vatan product record by numeric id, URL or slug. | product_id, max_rotations |
| product/stores | Which Vatan stores hold a product right now: every store with stock, its city, address, phone, coordinates, opening hours, whether it is a hyperstore, and the stock number Vatan publishes. Accepts the numeric id, URL or slug. | Catalog enrichment teams call product/stores to get which Vatan stores hold a product right now. | product_id, max_rotations |
| search/suggest | Vatan's own search-box list for a partial keyword: the matching products with numeric id, title, price, URL, image and category, plus the suggested categories. | Retail analysts call search/suggest to get vatan's own search-box list for a partial keyword. | query, limit, max_rotations |
| deals | Vatan's deal lists as product rows: Fırsat Ürünler, Web'e Özel prices or Outlet items, with the same fields, sorting and paging as search. | Pricing teams call deals to get vatan's deal lists as product rows. | type, page, sort, max_rotations |
Call search from your stack
curl -X POST https://api.reefapi.com/vatan/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"kulaklık"}'import requests
r = requests.post(
"https://api.reefapi.com/vatan/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "kulaklık"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/vatan/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "kulaklık"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.vatan.search with {"query":"kulaklık"}.Who uses this API and why
- Brands and distributors track Vatan's online price, Web'e Özel price and basket-only offers by product code or MPN.
- Price-comparison sites match Vatan products to other Turkish retailers by MPN, returned on 25 of 25 measured product records.
- Retail analysts sweep a category with brand, price-range and in-stock filters and read ratings per product.
- Local-availability tools show which Vatan store in which city holds a product, with coordinates and opening hours.
Questions developers ask before integrating
Is the basket ('sepette') price ever returned as the price?
No. A 'Gece'ye özel Sepette' offer is applied only in the basket, so it comes back as basket_price with its label, and price stays the product price. Measured on 2026-09-15: a Roborock robot vacuum came back as price 48,999 TL and basket_price 47,448 TL, and the price equalled the price in the product page's structured data.
What is the Web'e Özel price?
An online-only price. The product page shows the larger regular price in big type and the web price in a banner, while the page's own structured data, the instalment table and the basket all use the web price. The engine returns the web price as price, the larger one as regular_price, and price_label 'Web'e Özel'. Measured: 64,799 TL against 64,999 TL on a Roborock Q Revo Curv2 Pro.
Is stock returned?
In two places. product/detail returns availability: in_stock, out_of_stock_online when Vatan replaces the buy button with its store-stock button, or pre_order with the pre-order and sale dates. product/stores lists every Vatan store that holds the product, with the stock number Vatan publishes. Search cards carry no stock signal of their own, so search rows have no stock field; in_stock_only=true uses Vatan's own 'Stoktakiler' filter instead.
What happens when a keyword has no real match?
You get an empty result. On 2026-09-15 all 10 nonsense keywords came back empty from Vatan itself, with no filler products. The engine also checks that products on a keyword page contain a word of the query, or that the page's own category matches it, so a misspelling Vatan maps to the right category, like 'televizon', keeps its 164 televisions. Of 46 real Turkish searches, none was emptied by that check. Some real keywords are genuinely empty because Vatan does not list them: 'buzdolabı' and 'çamaşır makinesi' returned 0 products on the site.
What happens when Vatan redirects a keyword?
It is followed. 'laptop' goes to the notebook category, 'telefon' to mobile phones and 'iphone 16' to an Apple-filtered search, and the engine applies your sort, page, price and stock filters on the page it lands on; redirected_to says where that was. Measured: 'laptop' sorted by price ascending, page 2, came back from the notebook category in ascending price order. A brand keyword such as 'apple' goes to a brand page with no product list; the engine returns that page's categories in brand_landing with a notice, instead of an empty list without explanation.
Which filters actually filter?
Each was checked against the unfiltered result on 2026-09-15. 'kulaklık' returned 654 products. brand 'jbl' cut that to 148, every row a JBL product. 1,000 to 2,000 TL gave 141, every price inside the range. in_stock_only gave 478. The notebook category returned 180 products; brand 'lenovo' gave 19, all Lenovo, and 30,000 to 40,000 TL in stock sorted by price gave 9, ascending and inside the range. Both price sorts were monotone and page 2 shared no product with page 1.
Are reviews returned?
product/detail returns the rating, the review count and the review sample Vatan puts in the page's structured data, without reviewer names. There is no full review list: Vatan's own comment feed returns every comment of a product at once, over 8 MB for a popular phone, and mixes buyers' questions in with reviews under the same five-star mark, so it cannot be offered as a reliable review list.
What does Vatan NOT publish?
No EAN or GTIN is published on product pages; the MPN is. Search cards carry no review count and no stock flag. Big household appliances are not in Vatan's catalogue. Store stock is the number Vatan shows, without a unit definition. Outlet items have their own product records with a separate id.
What is the Vatan Bilgisayar API?
Vatan Bilgisayar API is a ReefAPI endpoint group for turkish electronics retailer: prices in try with web and basket prices apart, specs and store stock. It returns live JSON through POST requests under /vatan/v1.
Is the Vatan Bilgisayar API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Vatan Bilgisayar calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Vatan Bilgisayar login or account?
No login to Vatan Bilgisayar is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Vatan Bilgisayar data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Vatan Bilgisayar API use?
Vatan Bilgisayar actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Vatan Bilgisayar from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call vatan actions with the same key, credit pool and JSON envelope used by normal REST requests.