Vatan Bilgisayar's shelf as JSON: every price, every store
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.
5 active endpoints. Every call is 1 credit.
- POST/vatan/v1/search
- POST/vatan/v1/product/detail
- POST/vatan/v1/product/stores
- POST/vatan/v1/search/suggest
- POST/vatan/v1/deals
What Vatan Bilgisayar endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Vatan Bilgisayar API
3 of 5 endpoints, ready to run
Vatan products for a keyword or a category: slug, product code, title, images, online price in TRY, Web'e Özel and regular price, struck price, basket-only price, card rating and colour options, plus the categories, brands and price bands available.
{ "ok": true, "meta": { "api": "vatan", "endpoint": "search", "mode": "live", "latency_ms": 1719.8, "record_count": 24, "cache_hit": false }, "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 } }
How the Vatan Bilgisayar API works
Vatan Bilgisayar is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 252 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Find a product at Vatan, its real price, and the nearest store that has it
Search gives you the shelf with every kind of price. The product record settles which price applies, and the store list says where it is on the shelf today.
{"query": "robot süpürge", "sort": "price_asc", "in_stock_only": true}In-stock robot vacuums, cheapest first, each with price, Web'e Özel or basket-only price and slug.
{"product_id": "roborock-qrevo-2-pro-robot-supurge.html"}The product price, the basket-only offer kept apart, instalments, availability, specs and the numeric product_id.
{"product_id": "159339"}Every Vatan store holding it, with city, address, coordinates, opening hours and stock.
The real online price, the basket-only offer and the stores that hold the product, in three calls.
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"}'{
"ok": true,
"data": { … },
"meta": {
"api": "vatan",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
Which market, which id, which price, and what Vatan does not publish
vatanbilgisayar.com only: one country, one currency. Measured on 2026-09-15 across 51 live e2e cases, a 73-call reliability run, 56 no-match and redirect searches and a check against the rendered product page. Four of these lines go against us.
This engine reads vatanbilgisayar.com, a single Turkish storefront. Every price is a TRY number and the currency is stated on every row.
Search returns each product's URL slug; product/detail returns Vatan's numeric product_id, the product code and the MPN. product/detail and product/stores accept the numeric id, the full URL or the slug. A product that does not exist returns NOT_FOUND.
Measured on 2026-09-15 with 25 searches, 25 different product records, 10 store lists, 10 suggestion lists and 3 deal lists: 73 of 73 succeeded with the normal retry. With every call limited to a single attempt, 69 of 73 succeeded; the normal retry is there to absorb those. Median time: search 2.4 s, product record 2.5 s, store list 2.1 s, suggestions 1.9 s.
Seven products in four top categories were fetched through the API and as the product page, then compared with the page's own structured data and the visible prices: title, price, availability, rating and review count matched on 7 of 7, and no price shown in those pages' price areas went unreturned. A scan of every string in the live responses found no HTML tags or entities.
'kulaklık' returned 654 products; brand 'jbl' gave 148, all JBL; 1,000 to 2,000 TL gave 141, all inside the range; in-stock gave 478. Both price sorts were monotone and page 2 shared nothing with page 1. 'laptop' is redirected by Vatan to its notebook category and came back sorted and paged as asked.
Vatan's comment feed returns all comments at once and mixes questions in with reviews under the same star mark, so product/detail returns only the rating, the review count and the page's structured review sample.
Search cards look the same whether a product is in stock or not, so rows carry no stock field. Use in_stock_only, or product/detail and product/stores for one product.
Vatan publishes the MPN and its own product code on product pages, but no EAN or GTIN.
product/stores returns the stock figure Vatan shows per store. Most stores show 1 to 4, one showed 26; Vatan does not say whether it is a unit count or a level.
What people build with Vatan Bilgisayar
The jobs this data is most often used for.
endpoints
credit per call
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.
What Vatan Bilgisayar data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 252 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"])Have a question? We got answers.
The questions people actually ask before wiring up Vatan Bilgisayar.
Get a free key →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.
91 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Vatan Bilgisayar, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 251 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-09-15.