Veri & API

Son güncelleme: 4 Ekim 2026

YerelIndex verileri hem insanlar hem de makineler için tasarlanmıştır. Tüm uç noktalar herkese açıktır, JSON döner ve kararlı (v1) şemalar kullanır.

Uç noktalar

`GET /api/v1`	API dizini ve sürüm bilgisi
`GET /api/v1/businesses?cursor=&limit=&city=&category=`	İşletme listesi (cursor sayfalama)
`GET /api/v1/businesses/{id}`	Tek işletme (UUID)
`GET /api/v1/businesses/slug/{slug}`	Tek işletme (slug)
`GET /api/v1/search?q=tesisatci&city=izmir`	Arama (doğal dil sorgusu desteklenir)
`GET /api/v1/categories`	Kategori ağacı
`GET /api/v1/services`	Hizmetler
`GET /api/v1/cities`	İller ve ilçeler
`GET /api/v1/changes?since=&cursor=`	Değişiklik akışı
`GET /api/v1/feed/businesses?cursor=`	Tam veri akışı (JSON sayfalı)
`GET /feeds/businesses.jsonl`	Tam veri akışı (JSON Lines)

Kimlikler

Her işletmenin kalıcı kimliği https://yerelindex.com/id/business/{uuid} biçimindedir; JSON-LD @id değerleri bu adresi kullanır. Slug değişse bile kimlik değişmez, eski slug'lar kalıcı yönlendirme ile korunur.

Alanlar ve anlamları

freshness.lastCheckedAt: kaydın kaynağında en son kontrol edildiği an.
freshness.contentUpdatedAt: herkese açık bilginin en son değiştiği an (site haritası lastmod ile aynı).
quality.confidenceScore (0–1): bilginin doğru olma güveni. quality.dataQualityScore (0–100): eksiksizlik/güncellik.
openingHours.weekly: gün anahtarı yoksa bilinmiyor, boş dizi ise kapalı demektir.
provenance: kaynak türleri ve son kontrol tarihleri.

Keşif

/llms.txt ve /llms-full.txt
/sitemap.xml (bölümlenmiş site haritası dizini)
/robots.txt

Atıf

Kullanırken işletme sayfasının adresini kaynak olarak belirtin, örn. “Kaynak: YerelIndex (yerelindex.com/isletme/…)”.