# Sahibinden Scraper - Turkish Marketplace Data (`studio-amba/sahibinden-scraper`) Actor

Scrape classified listings from Sahibinden.com, Turkey's largest marketplace with 30M+ monthly visits. Extract car listings with prices, specs, seller info, and vehicle details. Supports search, category filtering, location, and price range. No login required.

- **URL**: https://apify.com/studio-amba/sahibinden-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** E-commerce
- **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 result scrapeds

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

## Sahibinden Scraper

Scrape classified listings from Sahibinden.com, Turkey's dominant marketplace with 30M+ monthly visits. Extract car listings, real estate, electronics, and more with full pricing, specs, and seller information.

### How to scrape Sahibinden data

1. Go to [Sahibinden Scraper](https://apify.com/studio-amba/sahibinden-scraper) on the Apify Store.
2. Click **Try for free** to open the actor in Apify Console.
3. Enter your search query (e.g., "volkswagen", "BMW 320d", "iPhone 16").
4. Choose a category (default: otomobil/cars) and optionally filter by location and price range.
5. Click **Start** and wait for the run to finish.
6. Download your data as JSON, CSV, Excel, or connect via API.

### Why use this actor?

Sahibinden.com is Turkey's largest classifieds platform -- the equivalent of Craigslist, AutoTrader, and Zillow combined. It dominates the Turkish market for second-hand cars, real estate, electronics, and services. This actor gives you structured access to listing data that would take hours to collect manually, with built-in anti-detection to handle the site's aggressive bot protection.

Use cases include market research for the Turkish automotive market, price monitoring for used cars, real estate market analysis across Turkish cities, and competitive intelligence for dealers and importers.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | Search term (e.g., "volkswagen", "BMW 320"). Defaults to "volkswagen". |
| `category` | String | No | Category: otomobil, arazi, motosiklet, emlak, cep-telefonu, bilgisayar, elektronik, vasita. Default: otomobil. |
| `location` | String | No | Turkish city filter (e.g., "istanbul", "ankara", "izmir"). Empty = all locations. |
| `priceFrom` | Integer | No | Minimum price in TRY. |
| `priceTo` | Integer | No | Maximum price in TRY. |
| `maxResults` | Integer | No | Maximum listings to return (default: 100, max: 10000). |
| `proxyConfiguration` | Object | No | Kept so older saved tasks keep working. Not read: the actor always uses Apify residential proxy in Turkey. |

### Output

Each listing contains:

| Field | Type | Example |
|-------|------|---------|
| `listingTitle` | String | `"Volkswagen Golf 1.6 TDI BlueMotion Comfortline"` |
| `price` | Number | `985000` |
| `currency` | String | `"TRY"` |
| `category` | String | `"Otomobil"` |
| `location` | String | `"Istanbul / Kadikoy"` |
| `date` | String | `"9 Haziran 2026"` |
| `sellerType` | String | `"Sahibinden"` or `"Galeri"` |
| `imageUrl` | String | Listing thumbnail URL |
| `url` | String | Full Sahibinden listing URL |
| `make` | String | `"Volkswagen"` |
| `model` | String | `"Golf"` |
| `year` | Number | `2020` |
| `mileage` | Number | `85000` |
| `fuelType` | String | `"Dizel"` |
| `transmission` | String | `"Otomatik"` |
| `scrapedAt` | String | ISO 8601 timestamp |

### Example output

```json
{
    "listingTitle": "Volkswagen Golf 1.6 TDI BlueMotion Comfortline",
    "price": 985000,
    "currency": "TRY",
    "category": "Otomobil",
    "location": "Istanbul / Kadikoy",
    "date": "9 Haziran 2026",
    "sellerType": "Sahibinden",
    "imageUrl": "https://i.sahibinden.com/photos/...",
    "url": "https://www.sahibinden.com/ilan/vasita-otomobil-volkswagen-golf-...",
    "make": "Volkswagen",
    "model": "Golf",
    "year": 2020,
    "mileage": 85000,
    "fuelType": "Dizel",
    "transmission": "Otomatik",
    "scrapedAt": "2026-06-09T14:30:00.000Z"
}
```

### Categories

Sahibinden.com covers all major classifieds categories in Turkey:

- **otomobil** -- Cars (most popular, default category)
- **arazi** -- SUVs, pickups, off-road vehicles
- **motosiklet** -- Motorcycles and scooters
- **vasita** -- All vehicles (cars + motorcycles + commercial)
- **emlak** -- Real estate (houses, apartments, land)
- **cep-telefonu** -- Mobile phones
- **bilgisayar** -- Computers and laptops
- **elektronik** -- Electronics and appliances

### Proxy requirements

Sahibinden.com blocks datacenter IPs and shows a bot check on listing pages. The actor loads the pages in a real browser (Camoufox) through Apify's residential proxy in Turkey, whatever you put in the proxy field. When a session is refused or sent to the login page, the actor closes it and starts a fresh one on a new Turkish IP.

If a search has no listings on Sahibinden.com, the run ends SUCCEEDED with 0 results and a status message saying so. A run only fails when every browser session was refused before the run timeout.

### Cost estimate

This actor uses Playwright with residential proxies to handle Sahibinden's anti-bot measures. It charges $0.04 per run (start fee, based on its 4 GB memory allocation) plus $0.005 per result. A 1,000-listing run costs about $5.04. Residential proxy bandwidth, if your Apify plan doesn't include it, is billed separately by Apify. A run's usage cost only settles after it reports SUCCEEDED.

### Tips for best results

- Use specific search queries for better results (e.g., "Volkswagen Golf" instead of just "araba")
- Filter by city to narrow results (Istanbul, Ankara, Izmir have the most listings)
- Set price ranges to focus on your target market segment
- Start with small maxResults (50-100) to validate your query before scaling up
- The car category extracts vehicle-specific fields (make, model, year, mileage, fuel, transmission)

### Limitations

- Sahibinden.com requires Turkish residential proxies -- datacenter proxies are blocked
- Phone numbers and seller contact details are behind login walls and not extracted
- Very high-volume scraping may trigger additional CAPTCHA challenges
- Data is scraped from the public website and may change without notice
- Some listing details (full specs, description text) require visiting individual listing pages
- The site may temporarily block IPs during peak traffic hours

### Integration

Use the Apify API to integrate Sahibinden data into your workflows:

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

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('studio-amba/sahibinden-scraper').call({
    searchQuery: 'volkswagen golf',
    category: 'otomobil',
    location: 'istanbul',
    maxResults: 200,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Found ${items.length} listings`);
```

# Actor input Schema

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

Search term to find listings on Sahibinden (e.g., 'volkswagen', 'BMW 320', 'iPhone 16'). Defaults to 'volkswagen' if empty.

## `category` (type: `string`):

Category to search in. Options: otomobil (cars), arazi (SUV/pickup), motosiklet (motorcycles), emlak (real estate), cep-telefonu (phones), bilgisayar (computers), elektronik (electronics), vasita (all vehicles).

## `location` (type: `string`):

Filter by Turkish city (e.g., 'istanbul', 'ankara', 'izmir'). Leave empty for all locations.

## `priceFrom` (type: `integer`):

Minimum price filter in Turkish Lira.

## `priceTo` (type: `integer`):

Maximum price filter in Turkish Lira.

## `maxResults` (type: `integer`):

Maximum number of listings to return.

## `brightDataApiKey` (type: `string`):

Optional. A Bright Data Web Unlocker key, tried once as a fallback when every browser session is refused. The actor works without it.

## `proxyConfiguration` (type: `object`):

Not read. The actor always uses Apify residential proxy in Turkey, because Sahibinden.com refuses datacenter and non-Turkish exits. Kept so saved tasks keep working.

## Actor input object example

```json
{
  "searchQuery": "volkswagen",
  "category": "otomobil",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "TR"
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "searchQuery": "volkswagen",
    "category": "otomobil",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "TR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/sahibinden-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 = {
    "searchQuery": "volkswagen",
    "category": "otomobil",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "TR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/sahibinden-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 '{
  "searchQuery": "volkswagen",
  "category": "otomobil",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "TR"
  }
}' |
apify call studio-amba/sahibinden-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/sahibinden-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/j1oc6Bj8XL8bM0x2g/builds/t9EHsrmWZ7cWNfpAd/openapi.json