sokmarket APIsokmarket.com.tr ↗
Access Şok Market's product catalog, pricing, weekly deals, campaigns, and category tree via 7 structured endpoints. Turkish grocery data in JSON.
What is the sokmarket API?
The Şok Market API gives developers structured access to sokmarket.com.tr's full product catalog across 7 endpoints, covering search, category browsing, product details, weekly deals, active campaigns, and checkout promotions. The get_product_details endpoint returns nutrition facts, ingredients, dimensions, and HTML content for any product identified by its slug. All responses are JSON with consistent product objects carrying price, brand, stock status, and image URLs.
curl -X GET 'https://api.parse.bot/scraper/0762f52c-d7dc-44fe-8df2-4d89c2ae075d/search_products?query=s%C3%BCt' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace sokmarket-com-tr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Şok Market API — browse categories, search products, inspect details."""
from parse_apis.şok_market_api import SokMarket, ProductNotFound
client = SokMarket()
# Search for products by keyword, capped at 5 results.
for product in client.products.search(query="süt", limit=5):
print(product.name, product.prices.discounted.text, product.brand.name)
# Browse categories and drill into one category's products.
category = client.categories.list(limit=1).first()
if category:
for item in category.products(limit=3):
print(item.name, item.has_stock, item.url)
# Get full product details from a search result.
product = client.products.search(query="ekmek", limit=1).first()
if product:
try:
detail = product.details()
print(detail.name, detail.html_content[:80] if detail.html_content else "")
for fact in detail.nutrition:
print(fact.label, fact.value)
except ProductNotFound as exc:
print(f"Product gone: {exc.slug}")
# Weekly deals — promotional products this week.
for deal in client.products.weekly_deals(limit=3):
print(deal.name, deal.prices.discounted.value)
print("exercised: products.search / categories.list / category.products / product.details / products.weekly_deals")
Full-text search over Şok Market products by keyword. Returns matching products with prices, brand, stock status, and images. Paginates as a single page of results per query.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'süt' for milk, 'ekmek' for bread) |
{
"type": "object",
"fields": {
"total": "integer total number of products found",
"products": "array of product objects with id, name, brand, prices, hasStock, images, url"
},
"sample": {
"data": {
"total": 65,
"products": [
{
"id": "5834",
"url": "https://www.sokmarket.com.tr/mis-uht-sut-yarim-yagli-1-l-p-5834",
"name": "Mis Uht Süt Yarım Yağlı 1 L",
"path": "mis-uht-sut-yarim-yagli-1-l-p-5834",
"brand": {
"id": 6,
"code": "mis",
"name": "MİS"
},
"images": [
{
"host": "https://images.ceptesok.com",
"path": "product-assets/sub-folder/9c33a0ed-7e67-48c7-8a7a-1c7baf32f01f.jpg"
}
],
"prices": {
"original": {
"text": "41,00",
"value": 41,
"symbol": "₺",
"currency": "TRY"
},
"discounted": {
"text": "41,00",
"value": 41,
"symbol": "₺",
"currency": "TRY"
}
},
"hasStock": true
}
]
},
"status": "success"
}
}About the sokmarket API
Product Search and Details
The search_products endpoint accepts a Turkish keyword (e.g. süt for milk, ekmek for bread) and returns a list of matching products including id, name, brand, prices, hasStock, images, and url. The integer total field tells you how many results matched. Once you have a product's path field, pass it as the slug parameter to get_product_details to retrieve the full record — including attributeMap with sub-keys coreInformation, dimensions, nutritionFacts, and htmlContent — plus a dedicated nutrition array of entries each carrying code, label, value, and order.
Category Browsing
The get_subcategories endpoint returns the full category tree as a content array. Each entry carries title, images, order, url, skuIds, and contentType. The url value serves directly as the slug parameter for get_category_products, which lists products page-by-page using the optional page integer. Both endpoints return the same product shape (id, name, brand, prices, hasStock, images, url) as search_products, so you can treat results uniformly.
Deals, Campaigns, and Checkout Promotions
get_weekly_deals returns this week's promoted products with a total count and the standard product array — no parameters required. get_campaigns returns active promotional campaigns with richer metadata: campaignId, campaignUrl, title, description, images, and an skuIds array linking campaigns to specific product SKUs. It also includes a page object with totalElements, totalPages, size, and number for pagination. get_checkout_products surfaces the impulse-buy items shown at checkout (Kasa Arkası Ürünler), again using the standard product object shape.
The sokmarket API is a managed, monitored endpoint for sokmarket.com.tr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sokmarket.com.tr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official sokmarket.com.tr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track real-time price changes on Şok Market products by polling
search_productsorget_category_productsdaily - Build a Turkish grocery price comparison tool using
pricesandbrandfields from product search results - Monitor weekly promotions with
get_weekly_dealsto alert users when specific categories go on discount - Extract nutrition facts and ingredient lists from
get_product_detailsfor a dietary tracking or allergen-screening app - Map the full category hierarchy using
get_subcategoriesto power a faceted browsing interface - Aggregate active campaign banners and their linked SKUs via
get_campaignsfor promotional analysis or ad monitoring - Identify checkout impulse-buy products with
get_checkout_productsto study discount merchandising patterns
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Şok Market have an official public developer API?+
What does `get_product_details` return beyond what appears in search results?+
get_product_details returns the full attributeMap object with coreInformation, dimensions, nutritionFacts, and htmlContent fields, plus a separate nutrition array with per-nutrient code, label, value, and order entries. Search and category endpoints return only the summary product object (id, name, brand, prices, hasStock, images, url) without this extended data.Does `get_category_products` support filtering by price range or brand within a category?+
slug and an optional page integer; it returns all products for that category page without server-side filtering. You can fork this API on Parse and revise it to add a filtering endpoint if your use case requires narrowing results by price or brand.Are product reviews or user ratings included in any endpoint?+
How does pagination work across endpoints?+
get_category_products accepts a page integer and returns a total count for that page. get_campaigns returns a page object with totalElements, totalPages, size, and number. search_products, get_weekly_deals, and get_checkout_products return a flat total integer but do not expose paginated navigation — all matching results are returned in a single products array.