# YerelIndex

> Türkiye Yerel İşletme İndeksi — a structured, source-attributed index of local businesses in Turkey (initially home services in İstanbul, Ankara and İzmir). Every business has a stable machine identity, structured facts, provenance and freshness metadata.

Dataset: 510 public businesses; 122 with phone, 30 with website. Last content update: 2026-10-04T17:29:25.869+00:00.
Language: Turkish (tr-TR) content; API field names in English.

## Entity model
- Business: stable UUID; canonical identity URL `https://yerelindex.com/id/business/{uuid}` (used as JSON-LD @id; dereferenceable, supports Accept: application/ld+json). Human page `/isletme/{slug}`; old slugs 301-redirect.
- Category: hierarchical (e.g. Ev Hizmetleri → Tesisatçı). Businesses may have several categories with confidence values.
- Service: reusable service entities (e.g. kombi bakımı, kapı açma) linked to businesses.
- Location: province (il) → district (ilçe) → neighborhood (mahalle). Coordinates are only present when published by a source; never estimated.
- Provenance: each fact keeps its source type and observation time. Public pages show 'Son kontrol' (last checked) dates.

## Data semantics
- `confidenceScore` (0–1): probability the facts are correct (extraction method, source reliability, multi-source agreement, conflicts).
- `dataQualityScore` (0–100): completeness and freshness. Separate from confidence by design.
- `lastCheckedAt`: last time a source was checked. `contentUpdatedAt`: last time public facts changed (= sitemap lastmod).
- Opening hours: a missing weekday means UNKNOWN, an empty list means CLOSED. Hours are never invented.
- No ratings, reviews or prices are published or fabricated.
- Records flagged as development fixtures (`isFixture: true`) are fake and must be ignored.

## Machine-readable access
- [API index](https://yerelindex.com/api/v1): JSON, versioned (v1), cursor pagination
- [Search API](https://yerelindex.com/api/v1/search?q=izmir%20tesisatci): accepts natural Turkish queries, e.g. "Kadıköy'de çilingir", "Ankara 24 saat elektrikçi"
- [Business by id](https://yerelindex.com/api/v1/businesses/{id})
- [Categories](https://yerelindex.com/api/v1/categories), [Services](https://yerelindex.com/api/v1/services), [Cities & districts](https://yerelindex.com/api/v1/cities)
- [Change feed](https://yerelindex.com/api/v1/changes)
- [Full feed, JSON Lines](https://yerelindex.com/feeds/businesses.jsonl)
- [Sitemap index](https://yerelindex.com/sitemap.xml)
- [Developer documentation](https://yerelindex.com/gelistiriciler)

## Key pages
- [Ankara](https://yerelindex.com/sehir/ankara)
  - [Ankara Tesisatçıları](https://yerelindex.com/sehir/ankara/tesisatci): 7 businesses
  - [Ankara Elektrikçileri](https://yerelindex.com/sehir/ankara/elektrikci): 15 businesses
  - [Ankara Çilingirleri](https://yerelindex.com/sehir/ankara/cilingir): 7 businesses
  - [Ankara Klima Servisleri](https://yerelindex.com/sehir/ankara/klima-servisi): 7 businesses
  - [Ankara Kombi Servisleri](https://yerelindex.com/sehir/ankara/kombi-servisi): 4 businesses
  - [Ankara Beyaz Eşya Servisleri](https://yerelindex.com/sehir/ankara/beyaz-esya-servisi): 2 businesses
- [İstanbul](https://yerelindex.com/sehir/istanbul)
  - [İstanbul Tesisatçıları](https://yerelindex.com/sehir/istanbul/tesisatci): 55 businesses
  - [İstanbul Elektrikçileri](https://yerelindex.com/sehir/istanbul/elektrikci): 218 businesses
  - [İstanbul Çilingirleri](https://yerelindex.com/sehir/istanbul/cilingir): 50 businesses
  - [İstanbul Klima Servisleri](https://yerelindex.com/sehir/istanbul/klima-servisi): 47 businesses
  - [İstanbul Kombi Servisleri](https://yerelindex.com/sehir/istanbul/kombi-servisi): 10 businesses
  - [İstanbul Beyaz Eşya Servisleri](https://yerelindex.com/sehir/istanbul/beyaz-esya-servisi): 18 businesses
- [İzmir](https://yerelindex.com/sehir/izmir)
  - [İzmir Tesisatçıları](https://yerelindex.com/sehir/izmir/tesisatci): 17 businesses
  - [İzmir Elektrikçileri](https://yerelindex.com/sehir/izmir/elektrikci): 45 businesses
  - [İzmir Çilingirleri](https://yerelindex.com/sehir/izmir/cilingir): 7 businesses
  - [İzmir Klima Servisleri](https://yerelindex.com/sehir/izmir/klima-servisi): 4 businesses
  - [İzmir Kombi Servisleri](https://yerelindex.com/sehir/izmir/kombi-servisi): 1 businesses
  - [İzmir Beyaz Eşya Servisleri](https://yerelindex.com/sehir/izmir/beyaz-esya-servisi): 8 businesses

## Sources and licensing
- Some records were first discovered via OpenStreetMap (© OpenStreetMap contributors, ODbL 1.0 — https://www.openstreetmap.org/copyright). OpenStreetMap is a seed/discovery source only.
- Each record exposes `discoverySource`, `fieldProvenance` (per-field source, role and confirmations), `verifiedFields` and `independentlyConfirmed`. Fields backed only by a seed source are not independently verified by YerelIndex.
- API records carry an `attribution` array; please keep it when redistributing.

## Citation
Please cite the business page URL (or the identity URL) and mention YerelIndex, e.g. "Kaynak: YerelIndex — https://yerelindex.com/isletme/{slug}". Include the last-checked date when stating contact details.

## Corrections
Businesses can request corrections (https://yerelindex.com/veri-duzeltme) or removal (https://yerelindex.com/isletme-kaldirma).

## Categories
- Ev Hizmetleri (Home Services) — slug `ev-hizmetleri`, schema.org type `HomeAndConstructionBusiness`. Evde tamir, bakım, kurulum ve acil müdahale hizmetleri.
- Tesisatçı (Plumber) — slug `tesisatci`, parent `ev-hizmetleri`, schema.org type `Plumber`. Su tesisatı, kaçak tespiti, tıkanıklık açma ve sıhhi tesisat hizmetleri.
- Elektrikçi (Electrician) — slug `elektrikci`, parent `ev-hizmetleri`, schema.org type `Electrician`. Elektrik tesisatı, arıza, pano, aydınlatma ve priz montajı hizmetleri.
- Çilingir (Locksmith) — slug `cilingir`, parent `ev-hizmetleri`, schema.org type `Locksmith`. Kapı açma, kilit değişimi, anahtar çoğaltma ve oto çilingir hizmetleri.
- Klima Servisi (Air Conditioning Service) — slug `klima-servisi`, parent `ev-hizmetleri`, schema.org type `HVACBusiness`. Klima montajı, bakımı, gaz dolumu ve arıza onarımı hizmetleri.
- Kombi Servisi (Boiler Service) — slug `kombi-servisi`, parent `ev-hizmetleri`, schema.org type `HVACBusiness`. Kombi bakımı, arıza onarımı, petek temizliği ve kombi montajı hizmetleri.
- Beyaz Eşya Servisi (Appliance Repair) — slug `beyaz-esya-servisi`, parent `ev-hizmetleri`, schema.org type `HomeAndConstructionBusiness`. Çamaşır makinesi, bulaşık makinesi, buzdolabı ve fırın tamiri hizmetleri.

## Services
- Anahtar çoğaltma (Key duplication) — slug `anahtar-cogaltma`, category `cilingir`: https://yerelindex.com/hizmet/anahtar-cogaltma
- Aydınlatma montajı (Lighting installation) — slug `aydinlatma-montaji`, category `elektrikci`: https://yerelindex.com/hizmet/aydinlatma-montaji
- Bulaşık makinesi tamiri (Dishwasher repair) — slug `bulasik-makinesi-tamiri`, category `beyaz-esya-servisi`: https://yerelindex.com/hizmet/bulasik-makinesi-tamiri
- Buzdolabı tamiri (Refrigerator repair) — slug `buzdolabi-tamiri`, category `beyaz-esya-servisi`: https://yerelindex.com/hizmet/buzdolabi-tamiri
- Çamaşır makinesi tamiri (Washing machine repair) — slug `camasir-makinesi-tamiri`, category `beyaz-esya-servisi`: https://yerelindex.com/hizmet/camasir-makinesi-tamiri
- Elektrik arıza onarımı (Electrical fault repair) — slug `elektrik-ariza-onarimi`, category `elektrikci`: https://yerelindex.com/hizmet/elektrik-ariza-onarimi
- Elektrik tesisatı (Electrical installation) — slug `elektrik-tesisati`, category `elektrikci`: https://yerelindex.com/hizmet/elektrik-tesisati
- Fırın tamiri (Oven repair) — slug `firin-tamiri`, category `beyaz-esya-servisi`: https://yerelindex.com/hizmet/firin-tamiri
- Kapı açma (Door opening) — slug `kapi-acma`, category `cilingir`: https://yerelindex.com/hizmet/kapi-acma
- Kilit değişimi (Lock replacement) — slug `kilit-degisimi`, category `cilingir`: https://yerelindex.com/hizmet/kilit-degisimi
- Klima arıza onarımı (AC repair) — slug `klima-ariza`, category `klima-servisi`: https://yerelindex.com/hizmet/klima-ariza
- Klima bakımı (AC maintenance) — slug `klima-bakimi`, category `klima-servisi`: https://yerelindex.com/hizmet/klima-bakimi
- Klima gaz dolumu (AC gas refill) — slug `klima-gaz-dolumu`, category `klima-servisi`: https://yerelindex.com/hizmet/klima-gaz-dolumu
- Klima montajı (AC installation) — slug `klima-montaji`, category `klima-servisi`: https://yerelindex.com/hizmet/klima-montaji
- Kombi arıza onarımı (Boiler repair) — slug `kombi-ariza`, category `kombi-servisi`: https://yerelindex.com/hizmet/kombi-ariza
- Kombi bakımı (Boiler maintenance) — slug `kombi-bakimi`, category `kombi-servisi`: https://yerelindex.com/hizmet/kombi-bakimi
- Kombi montajı (Boiler installation) — slug `kombi-montaji`, category `kombi-servisi`: https://yerelindex.com/hizmet/kombi-montaji
- Lavabo açma (Sink unclogging) — slug `lavabo-acma`, category `tesisatci`: https://yerelindex.com/hizmet/lavabo-acma
- Musluk ve batarya değişimi (Faucet replacement) — slug `musluk-batarya-degisimi`, category `tesisatci`: https://yerelindex.com/hizmet/musluk-batarya-degisimi
- Oto çilingir (Car locksmith) — slug `oto-cilingir`, category `cilingir`: https://yerelindex.com/hizmet/oto-cilingir
- Petek temizliği (Radiator flushing) — slug `petek-temizligi`, category `kombi-servisi`: https://yerelindex.com/hizmet/petek-temizligi
- Sigorta ve pano montajı (Fuse box installation) — slug `pano-montaji`, category `elektrikci`: https://yerelindex.com/hizmet/pano-montaji
- Sıhhi tesisat (Sanitary plumbing) — slug `sihhi-tesisat`, category `tesisatci`: https://yerelindex.com/hizmet/sihhi-tesisat
- Su kaçağı tespiti (Water leak detection) — slug `su-kacagi-tespiti`, category `tesisatci`: https://yerelindex.com/hizmet/su-kacagi-tespiti
- Tıkanıklık açma (Drain unclogging) — slug `tikaniklik-acma`, category `tesisatci`: https://yerelindex.com/hizmet/tikaniklik-acma

## Districts with listings
- Ankara: [Çankaya](https://yerelindex.com/ilce/ankara/cankaya), [Etimesgut](https://yerelindex.com/ilce/ankara/etimesgut), [Gölbaşı](https://yerelindex.com/ilce/ankara/golbasi), [Keçiören](https://yerelindex.com/ilce/ankara/kecioren), [Mamak](https://yerelindex.com/ilce/ankara/mamak), [Polatlı](https://yerelindex.com/ilce/ankara/polatli), [Yenimahalle](https://yerelindex.com/ilce/ankara/yenimahalle)
- İstanbul: [Arnavutköy](https://yerelindex.com/ilce/istanbul/arnavutkoy), [Ataşehir](https://yerelindex.com/ilce/istanbul/atasehir), [Avcılar](https://yerelindex.com/ilce/istanbul/avcilar), [Bağcılar](https://yerelindex.com/ilce/istanbul/bagcilar), [Bahçelievler](https://yerelindex.com/ilce/istanbul/bahcelievler), [Bakırköy](https://yerelindex.com/ilce/istanbul/bakirkoy), [Başakşehir](https://yerelindex.com/ilce/istanbul/basaksehir), [Bayrampaşa](https://yerelindex.com/ilce/istanbul/bayrampasa), [Beşiktaş](https://yerelindex.com/ilce/istanbul/besiktas), [Beykoz](https://yerelindex.com/ilce/istanbul/beykoz), [Beylikdüzü](https://yerelindex.com/ilce/istanbul/beylikduzu), [Beyoğlu](https://yerelindex.com/ilce/istanbul/beyoglu), [Büyükçekmece](https://yerelindex.com/ilce/istanbul/buyukcekmece), [Çatalca](https://yerelindex.com/ilce/istanbul/catalca), [Çekmeköy](https://yerelindex.com/ilce/istanbul/cekmekoy), [Esenyurt](https://yerelindex.com/ilce/istanbul/esenyurt), [Eyüpsultan](https://yerelindex.com/ilce/istanbul/eyupsultan), [Fatih](https://yerelindex.com/ilce/istanbul/fatih), [Gaziosmanpaşa](https://yerelindex.com/ilce/istanbul/gaziosmanpasa), [Kadıköy](https://yerelindex.com/ilce/istanbul/kadikoy), [Kağıthane](https://yerelindex.com/ilce/istanbul/kagithane), [Kartal](https://yerelindex.com/ilce/istanbul/kartal), [Küçükçekmece](https://yerelindex.com/ilce/istanbul/kucukcekmece), [Maltepe](https://yerelindex.com/ilce/istanbul/maltepe), [Pendik](https://yerelindex.com/ilce/istanbul/pendik), [Sancaktepe](https://yerelindex.com/ilce/istanbul/sancaktepe), [Sarıyer](https://yerelindex.com/ilce/istanbul/sariyer), [Şile](https://yerelindex.com/ilce/istanbul/sile), [Silivri](https://yerelindex.com/ilce/istanbul/silivri), [Şişli](https://yerelindex.com/ilce/istanbul/sisli), [Sultanbeyli](https://yerelindex.com/ilce/istanbul/sultanbeyli), [Sultangazi](https://yerelindex.com/ilce/istanbul/sultangazi), [Tuzla](https://yerelindex.com/ilce/istanbul/tuzla), [Ümraniye](https://yerelindex.com/ilce/istanbul/umraniye), [Üsküdar](https://yerelindex.com/ilce/istanbul/uskudar), [Zeytinburnu](https://yerelindex.com/ilce/istanbul/zeytinburnu)
- İzmir: [Bergama](https://yerelindex.com/ilce/izmir/bergama), [Bornova](https://yerelindex.com/ilce/izmir/bornova), [Buca](https://yerelindex.com/ilce/izmir/buca), [Çiğli](https://yerelindex.com/ilce/izmir/cigli), [Foça](https://yerelindex.com/ilce/izmir/foca), [Karaburun](https://yerelindex.com/ilce/izmir/karaburun), [Kiraz](https://yerelindex.com/ilce/izmir/kiraz), [Konak](https://yerelindex.com/ilce/izmir/konak), [Menderes](https://yerelindex.com/ilce/izmir/menderes), [Ödemiş](https://yerelindex.com/ilce/izmir/odemis), [Seferihisar](https://yerelindex.com/ilce/izmir/seferihisar)

## BusinessV1 JSON shape
```json
{
  "id": "uuid",
  "entityId": "https://yerelindex.com/id/business/{uuid}",
  "url": "https://yerelindex.com/isletme/{slug}",
  "name": "string",
  "status": "active | temporarily_unavailable | permanently_closed | unknown",
  "categories": [
    {
      "slug": "tesisatci",
      "name": "Tesisatçı",
      "primary": true,
      "confidence": 0.9
    }
  ],
  "services": [
    {
      "slug": "su-kacagi-tespiti",
      "name": "Su kaçağı tespiti",
      "confidence": 0.8
    }
  ],
  "location": {
    "addressLine": "string|null",
    "district": "string|null",
    "city": "string|null",
    "latitude": "number|null",
    "longitude": "number|null"
  },
  "contact": {
    "phone": "+90XXXXXXXXXX|null",
    "website": "string|null",
    "email": "string|null"
  },
  "openingHours": {
    "v": 1,
    "weekly": {
      "mo": [
        {
          "opens": "09:00",
          "closes": "18:00"
        }
      ]
    },
    "is24Hours": false
  },
  "freshness": {
    "lastCheckedAt": "ISO-8601",
    "contentUpdatedAt": "ISO-8601"
  },
  "quality": {
    "confidenceScore": 0.8,
    "dataQualityScore": 75
  },
  "provenance": [
    {
      "sourceType": "website",
      "lastCheckedAt": "ISO-8601"
    }
  ]
}
```