# Yemeksepeti Scraper — Restaurants, Menus & Prices (Turkey) (`teodor_banea/yemeksepeti-restaurant-menu-scraper`) Actor

Scrape Yemeksepeti (Turkey): restaurants delivering to any point with rating, delivery time, fees, minimum order, offers and opening hours, or full menus with one row per item size, prices in TRY, discounts and option groups.

- **URL**: https://apify.com/teodor_banea/yemeksepeti-restaurant-menu-scraper.md
- **Developed by:** [Banea Teodor](https://apify.com/teodor_banea) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yemeksepeti Restaurant & Menu Scraper

### What does Yemeksepeti Restaurant & Menu Scraper do?

This Actor extracts restaurants and **full menus with prices in Turkish lira (TRY)** from **[Yemeksepeti](https://www.yemeksepeti.com)**, Turkey's largest food-delivery platform. Enter a delivery point as `"latitude,longitude"` (anywhere in Turkey) or paste restaurant URLs, and get clean JSON:

- **Restaurant list**: every restaurant that delivers to your point, in the platform's order, with rating and rating count, cuisines, price level, delivery time, distance, delivery fee, minimum order, active offers, open/closed state, address, coordinates, phone and legal entity (legal entity for registered companies only; names and mobile numbers of sole traders and private partnerships are left empty). Optionally opening hours, topic ratings, deals and description.
- **Full menus**: **one flat row per item size**: a pizza with three sizes gives three rows that share `productId` and each carry their own `price`. Every row has the struck-through price and discount percent when a discount runs, the packaging fee, sold-out flag, popular flag and like share, vegetarian/alcohol/dietary flags, and the **option groups** of that size (toppings, sides, drink choice) with every option's price.

No browser and no login are needed, so runs are fast and cheap. The two-restaurant example input finishes in a few seconds.

### Why use this Actor?

- **Menu price monitoring in TRY**: one row per size loads straight into a spreadsheet or a database. There are no nested item lists to unpack, and prices are numbers.
- **Discounts made visible**: `priceOriginal`, `priceDiscounted` and `discountPercent` on every discounted item, plus restaurant-level `offers` ("Tüm ürünlerde %20").
- **Option groups with prices**: see what extra cheese, a larger drink or a menu upgrade costs, with min/max selection rules.
- **Market maps**: "who delivers to this point" with ratings, fees, minimum orders and delivery times for any neighbourhood in Istanbul, Ankara, Izmir or any other Turkish city.
- **Same columns as our other delivery scrapers**: our [Deliveroo](https://apify.com/store?search=deliveroo%20restaurant%20menu), [Wolt](https://apify.com/store?search=wolt%20restaurant%20menu), [Glovo](https://apify.com/store?search=glovo%20restaurant%20menu), [Bolt Food](https://apify.com/store?search=bolt%20food%20restaurant) and [efood](https://apify.com/store?search=efood%20restaurant%20menu) scrapers use the same field names (`storeId`, `name`, `price`, `modifierGroups`…), so you can compare platforms side by side.

### How much does it cost?

You pay per row returned, plus a small start fee per run.

| Run | Rows | Typical cost |
|---|---|---|
| Example input (2 restaurants, 25 rows each) | 50 | ~$0.11 |
| All restaurants delivering to one Istanbul point | ~550 | ~$1.10 |
| 10 restaurants, complete menus | ~1,000–1,500 | ~$2–3 |
| 1 restaurant URL, complete menu | 30–300 | ~$0.07–0.60 |

Use `maxRestaurants`, `maxItemsPerRestaurant` and `maxItemsTotal` to bound any run.

### Input

| Field | Type | Description | Example |
|---|---|---|---|
| `mode` | string | `restaurants` (one row per restaurant, default) or `menus` (one row per menu item size). | `"menus"` |
| `locations` | array of strings | Delivery points in Turkey as `"latitude,longitude"`. | `["41.0082,28.9784"]` |
| `restaurantUrls` | array of strings | Restaurant pages or bare restaurant codes. | `["https://www.yemeksepeti.com/restaurant/cii9/papa-johns-pizza-cii9"]` |
| `language` | string | `tr` (default) or `en` for cuisine names, deal titles and translated menu texts. | `"en"` |
| `searchQuery` | string | Keep restaurants whose name, chain or cuisine contains this text (`doner` matches `Döner`). | `"lahmacun"` |
| `cuisines` | array of strings | Keep restaurants with one of these cuisines. | `["Pizza"]` |
| `onlyOpen` | boolean | Keep only restaurants taking delivery orders now. | `true` |
| `minRating` | string | Keep restaurants rated at least this. | `"4.2"` |
| `sortBy` | string | `platform` (default), `distance`, `rating`, `deliveryFee`, `minimumOrder`. | `"rating"` |
| `maxRestaurants` | integer | Restaurants per run (0 = all of your points, up to 3,000). | `20` |
| `maxItemsPerRestaurant` | integer | Menus mode: first N rows of each menu (0 = complete menus). | `25` |
| `maxItemsTotal` | integer | Hard ceiling on billed rows for the run (0 = no ceiling). | `5000` |
| `includeModifiers` | boolean | Menus mode: attach option groups with option prices (default on). | `true` |
| `includeDetails` | boolean | Restaurants mode: also read opening hours, deals, topic ratings, legal entity, description. | `true` |

Notes:

- **A restaurant list is "who delivers to this point right now"**: the same restaurants a customer at that address sees, including closed ones (`isOpen: false`, with `closeReasons` or `opensAt`). Distance, delivery time, fee and minimum order are for that point.
- **One row per size/variation**: `maxItemsPerRestaurant` and `maxItemsTotal` count these rows. `variationName` is null when a product has only one size.
- **Prices are in TRY** and are the price a customer pays at scrape time. When a discount runs, `price` is the discounted price and `priceOriginal` the struck-through price.
- **Empty menus** (a restaurant with nothing orderable right now) are skipped and do not count toward `maxRestaurants`; the next restaurant in the list takes the slot. After examining `maxRestaurants × 3 + 10` restaurants the run stops looking.
- **Restaurants given by URL** have no delivery point, so their distance and delivery time are empty and fees/minimum order are the restaurant's base values.
- Filters and orders apply to restaurants found for your points. Any order other than `platform` reads the full list of every point first.
- **Review texts are out of scope**: you get rating, rating count and topic ratings, never reviewer names or comments.

### Output

Menus mode: one row per menu item size.

```json
{
    "rowType": "menuItem",
    "storeId": "ab12",
    "storeName": "Örnek Döner Evi",
    "storeSlug": "ornek-doner-evi-ab12",
    "storeUrl": "https://www.yemeksepeti.com/restaurant/ab12/ornek-doner-evi-ab12",
    "storeCity": "Istanbul",
    "storeCuisine": ["Döner", "Kebap & Türk Mutfağı"],
    "storeRating": 4.5,
    "storeIsOpen": true,
    "searchLocation": "41.0082,28.9784",
    "currency": "TRY",
    "categoryId": "3327351",
    "categoryName": "Dürümler",
    "categoryDescription": null,
    "categoryPosition": 2,
    "productId": "44487160",
    "productCode": "00000000-0000-0000-0000-000000000001",
    "variationId": "52619180",
    "variationName": "1,5 Porsiyon",
    "variationCount": 2,
    "name": "Et Döner Dürüm",
    "description": "Yaprak et döner, lavaş, domates, soğan, maydanoz",
    "price": 552.5,
    "priceOriginal": 650,
    "priceDiscounted": 552.5,
    "discountPercent": 15,
    "priceText": "552,50 TL",
    "containerPrice": 0,
    "unitPriceText": null,
    "isPopular": true,
    "likedPercent": 94,
    "likeVotes": 181,
    "isAvailable": true,
    "isAlcoholic": false,
    "isVegetarian": false,
    "isBundle": false,
    "isPrepacked": false,
    "spiciness": null,
    "dietaryTags": [],
    "additives": [],
    "hasOptions": true,
    "modifierGroups": [
        {
            "id": "15714250",
            "name": "İçecek Seçimi",
            "description": null,
            "minSelection": 1,
            "maxSelection": 1,
            "options": [
                { "id": "119920007", "name": "Ayran (300 ml)", "description": null, "price": 0, "isAvailable": true, "modifierGroupIds": [] },
                { "id": "119920008", "name": "Kola (330 ml)", "description": null, "price": 25, "isAvailable": true, "modifierGroupIds": [] }
            ]
        }
    ],
    "tags": ["popular"],
    "imageUrl": "https://images.example.com/products/44487160.jpg",
    "position": 7,
    "scrapedAt": "2026-11-12T14:19:21.539Z",
    "runId": "AbC123dEf456"
}
```

Restaurants mode: one row per restaurant (this one with `includeDetails`).

```json
{
    "rowType": "restaurant",
    "storeId": "ab12",
    "storeNumericId": 123456,
    "name": "Örnek Döner Evi",
    "slug": "ornek-doner-evi-ab12",
    "url": "https://www.yemeksepeti.com/restaurant/ab12/ornek-doner-evi-ab12",
    "sourceUrl": null,
    "searchLocation": "41.0082,28.9784",
    "city": "Istanbul",
    "countryCode": "TR",
    "currency": "TRY",
    "vertical": "restaurants",
    "chainName": null,
    "chainCode": null,
    "rating": 4.5,
    "ratingCount": 1221,
    "reviewsWithCommentCount": 0,
    "topicRatings": { "overall": 4.5, "restaurantFood": 4.5, "deliveryTime": 4.4, "rider": 5, "service": 4.5 },
    "cuisine": ["Döner", "Pilav"],
    "primaryCuisine": "Döner",
    "foodCharacteristics": ["Restoran Teslimatlı"],
    "priceLevel": 2,
    "etaMinutes": 35,
    "etaText": "25–40 min",
    "pickupEtaMinutes": 15,
    "distanceKm": 3.54,
    "deliveryFee": 0,
    "deliveryFeeType": "amount",
    "isFreeDelivery": true,
    "minimumOrder": 550,
    "serviceFeePercent": 0,
    "smallOrderFee": null,
    "paymentTypes": [],
    "offers": ["Seçili ürünlerde %10"],
    "hasDiscount": true,
    "isPromoted": true,
    "isNew": false,
    "isBestInCity": false,
    "isSuperVendor": true,
    "isBusy": false,
    "isOpen": true,
    "isTemporarilyClosed": false,
    "closeReasons": [],
    "opensAt": null,
    "hasDelivery": true,
    "hasPickup": true,
    "deliveryProvider": "vendor_delivery",
    "openingHours": [
        { "day": "Monday", "opens": "10:30", "closes": "23:30", "type": "delivery" }
    ],
    "openingHoursText": "Mon 10:30–23:30; Tue 10:30–23:00; Wed 10:30–23:00; Thu 10:30–23:30; Fri 10:30–23:30; Sat 10:30–23:30; Sun 10:30–23:30",
    "address": "Örnek Mah. Örnek Cad. No: 1",
    "postcode": null,
    "latitude": 41.0056,
    "longitude": 28.9364,
    "phone": "+902120000000",
    "legalName": "ÖRNEK GIDA SANAYİ VE TİCARET LİMİTED ŞİRKETİ",
    "tradeRegisterNumber": "0000000000000001",
    "description": null,
    "logoUrl": null,
    "imageUrl": "https://images.example.com/hero/ab12.jpg",
    "listPosition": 1,
    "scrapedAt": "2026-11-12T14:11:17.091Z",
    "runId": "AbC123dEf456"
}
```

A run returns one of the two shapes (per the mode), so exports are always uniform. Menus mode also stores one full restaurant record per scraped menu under the `RESTAURANTS` key of the run's key-value store (join on `storeId`). Problems are listed under `ERRORS` with a reason (`notFound`, `outsideTurkey`, `noRestaurants`, `blocked`, `requestFailed`, `invalidInput`, `unexpectedResponse`).

### Tips and tricks

- **Price monitoring**: schedule a menus run on the same restaurant URLs (daily or weekly) and compare by `storeId` + `variationId`. `scrapedAt` and `runId` keep runs apart after export.
- **Competitor menus**: combine `searchQuery` (e.g. `"burger"`) or `cuisines` with a few points across a city, `mode: menus` and `maxItemsPerRestaurant` for a cheap overview of competing menus and price levels.
- **Market maps**: restaurants mode with `maxRestaurants: 0` returns every restaurant delivering to a point (several hundred in central Istanbul) with coordinates, fees, minimum orders and ratings. Several points cover a district.
- **Run during opening hours** for complete delivery times and open states. Closed restaurants are still listed, and their menus are scraped when the restaurant publishes them.
- **Smaller rows**: switch `includeModifiers` off for flat, CSV-friendly menu rows.
- **English texts**: `language: "en"` translates cuisine names and deal titles; menu texts are translated only where the restaurant provides a translation.

### Integrations

The dataset works with every Apify integration: export to **JSON, CSV or Excel**, push to **Google Sheets**, trigger **webhooks** or **Zapier/Make** on finish, or read it via the **Apify API** from Python or Node.js. A typical example is a weekly menu-price snapshot feeding a pricing dashboard.

# Changelog

This Actor's version history is a separate document: https://apify.com/teodor_banea/yemeksepeti-restaurant-menu-scraper/changelog.md

# Actor input Schema

## `mode` (type: `string`):

"Restaurant list" returns one row per restaurant that delivers to your point (rating, delivery time, fees, minimum order, offers, open state). "Full menus with prices" opens each restaurant and returns one row per menu item size, with option groups and option prices — a typical restaurant has 30–300 rows.

## `locations` (type: `array`):

Enter delivery points in Turkey as "latitude,longitude", e.g. "41.0082,28.9784" (Istanbul, Sultanahmet) or "39.9208,32.8541" (Ankara). Each point returns the restaurants that deliver there, in the platform's order.

## `restaurantUrls` (type: `array`):

Enter Yemeksepeti restaurant pages (https://www.yemeksepeti.com/restaurant/cii9/papa-johns-pizza-cii9) or just their codes (cii9). These are scraped directly, in addition to any delivery points.

## `language` (type: `string`):

Pick the language of cuisine names, deal titles and (where the restaurant provides translations) menu texts.

## `searchQuery` (type: `string`):

Keep only restaurants whose name, chain or cuisine contains this text. Case- and Turkish-letter-insensitive: "doner" matches "Döner".

## `cuisines` (type: `array`):

Keep only restaurants with one of these cuisines, e.g. "Pizza", "Döner", "Burger" (same matching as the search text).

## `onlyOpen` (type: `boolean`):

Keep only restaurants that take delivery orders at the time of the run.

## `minRating` (type: `string`):

Keep only restaurants rated at least this (1–5), e.g. "4.2". Unrated restaurants are dropped when this is set.

## `sortBy` (type: `string`):

Order of the restaurants before the limit applies. Any order other than the platform's reads the full restaurant list of every point first (one or two extra seconds per point).

## `maxRestaurants` (type: `integer`):

Limit the restaurants scraped in the whole run (restaurant rows, or menus opened). Set 0 for all restaurants of your points (up to 3,000). In menus mode, restaurants with an empty menu are skipped and do not count.

## `maxItemsPerRestaurant` (type: `integer`):

In menus mode, keep only the first N rows (item sizes) of each menu, in menu order. Set 0 for complete menus.

## `maxItemsTotal` (type: `integer`):

Set a hard ceiling on billed rows for the whole run; the run stops as soon as it is reached. Set 0 for no ceiling (a safety guard of 50,000 rows still applies).

## `includeModifiers` (type: `boolean`):

In menus mode, attach each item size's option groups (toppings, sides, drink choices) with option prices. Switch off for smaller, CSV-friendly rows.

## `includeDetails` (type: `boolean`):

In restaurants mode, open each restaurant once more for opening hours, deals, topic ratings, legal entity and description. Slower (one more request per restaurant); restaurant URLs always get these details.

## Actor input object example

```json
{
  "mode": "menus",
  "locations": [
    "41.0082,28.9784"
  ],
  "restaurantUrls": [
    "https://www.yemeksepeti.com/restaurant/cii9/papa-johns-pizza-cii9"
  ],
  "language": "tr",
  "cuisines": [
    "Pizza"
  ],
  "onlyOpen": false,
  "minRating": "4.2",
  "sortBy": "platform",
  "maxRestaurants": 2,
  "maxItemsPerRestaurant": 25,
  "maxItemsTotal": 0,
  "includeModifiers": true,
  "includeDetails": false
}
```

# Actor output Schema

## `results` (type: `string`):

Every row of the run as JSON.

## `menu` (type: `string`):

Menus mode: restaurant, category, item, size, price, discount, availability.

## `restaurants` (type: `string`):

Restaurants mode: position, name, cuisines, rating, delivery time, distance, fee, minimum order, offers.

## `resultsCsv` (type: `string`):

The same rows as a CSV download.

## `restaurantRecords` (type: `string`):

One full restaurant record per scraped menu (opening hours, fees, legal entity), joinable on storeId.

## `errors` (type: `string`):

Restaurants not found, points outside Turkey or without restaurants, and requests that failed. Only present when something went wrong.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "menus",
    "locations": [
        "41.0082,28.9784"
    ],
    "maxRestaurants": 2,
    "maxItemsPerRestaurant": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("teodor_banea/yemeksepeti-restaurant-menu-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "menus",
    "locations": ["41.0082,28.9784"],
    "maxRestaurants": 2,
    "maxItemsPerRestaurant": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("teodor_banea/yemeksepeti-restaurant-menu-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "menus",
  "locations": [
    "41.0082,28.9784"
  ],
  "maxRestaurants": 2,
  "maxItemsPerRestaurant": 25
}' |
apify call teodor_banea/yemeksepeti-restaurant-menu-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,teodor_banea/yemeksepeti-restaurant-menu-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/f1qZ1qegM6Ug63ovT/builds/q5mYIjP3IgjlAzXnh/openapi.json
