{"status":"success","openapi":"3.1.0","info":{"title":"BirMakine Public API","version":"1.0.0","description":"BirMakine — Türkiye iş makinesi, endüstriyel ekipman ve ağır vasıta ilan pazaryeri. Read-only, kimlik-doğrulamasız JSON API. Kişisel veri (telefon/e-posta) döndürmez. Hız sınırı: IP başına 240 istek/dk. Ayrıca WebMCP (document.modelContext) ve Markdown (.md) uçları mevcuttur.","contact":{"url":"https://birmakine.com/webmcp"}},"servers":[{"url":"https://birmakine.com"}],"externalDocs":{"description":"WebMCP \u0026 AI dokümanı","url":"https://birmakine.com/webmcp"},"paths":{"/api/v1/ara":{"get":{"operationId":"aramaYap","summary":"İlan arar. Teknik-özellik filtresi için spec[Ad]=Değer parametresi (ör. spec[Voltaj]=380V) eklenebilir.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Anahtar kelime"},{"name":"kategori","in":"query","required":false,"schema":{"type":"string"},"description":"Kategori slug"},{"name":"fiyat_min","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Min fiyat (TL)"},{"name":"fiyat_max","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Max fiyat (TL)"},{"name":"sehir","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Şehir/plaka id"},{"name":"satici","in":"query","required":false,"schema":{"type":"string"},"description":"Satıcı slug"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["yeni","eski","fiyat_artan","fiyat_azalan","uygunluk"]},"description":"Sıralama"},{"name":"sayfa","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Sayfa no"},{"name":"adet","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Sayfa başına (max 30)"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/kategori-ozet":{"get":{"operationId":"kategoriOzet","summary":"Kategori pazar özeti: toplam ilan, satıcı sayısı, fiyat bandı, popüler üretici markaları.","parameters":[{"name":"kategori","in":"query","required":true,"schema":{"type":"string"},"description":"Kategori slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/spec-facet":{"get":{"operationId":"specSecenekleri","summary":"Kategorinin teknik-özellik filtre seçeneklerini (Voltaj/Güç/Kapasite…) değer+adetle döndürür.","parameters":[{"name":"kategori","in":"query","required":true,"schema":{"type":"string"},"description":"Kategori slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/ilan/{slug}":{"get":{"operationId":"ilanDetay","summary":"İlan detayı (PII yok).","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"İlan slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/benzer/{slug}":{"get":{"operationId":"benzerIlan","summary":"Bir ilana benzer ilanlar.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"İlan slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/kategoriler":{"get":{"operationId":"kategoriler","summary":"Tüm ilan kategorileri + ilan sayısı.","responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/markalar":{"get":{"operationId":"markalar","summary":"Üretici markaları.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Marka adı araması"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/marka/{slug}/ilanlar":{"get":{"operationId":"markaIlanlari","summary":"Bir markanın ilanları.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Marka slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/satici/{slug}":{"get":{"operationId":"saticiProfil","summary":"Satıcı profili (PII yok).","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Satıcı slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/istatistik":{"get":{"operationId":"pazarIstatistik","summary":"Pazar istatistiği: toplam ilan, fiyat aralığı, popüler kategoriler.","responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/sss":{"get":{"operationId":"sss","summary":"Sık sorulan sorular.","responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/blog":{"get":{"operationId":"blogAra","summary":"Blog/rehber yazılarını arar.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Anahtar kelime"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/blog/{slug}":{"get":{"operationId":"blogGetir","summary":"Blog yazısı içeriği.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Yazı slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/api/v1/yazar/{slug}":{"get":{"operationId":"yazarGetir","summary":"Blog yazarı uzmanlık/bilgi.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Yazar slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/ilan/{slug}.md":{"get":{"operationId":"ilanMarkdown","summary":"İlan detayı (Markdown, LLM-dostu).","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"İlan slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/kategori/{slug}.md":{"get":{"operationId":"kategoriMarkdown","summary":"Kategori özeti (Markdown).","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Kategori slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/marka/{slug}.md":{"get":{"operationId":"markaMarkdown","summary":"Marka özeti (Markdown).","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Marka slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/satici/{slug}.md":{"get":{"operationId":"saticiMarkdown","summary":"Satıcı özeti (Markdown).","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Satıcı slug"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}},"/urun-feed":{"get":{"operationId":"urunFeed","summary":"Tüm aktif ilanlar (NDJSON). Keyset sayfalama: yanıttaki Link rel=next başlığını takip edin.","parameters":[{"name":"before","in":"query","required":false,"schema":{"type":"integer","minimum":0},"description":"Keyset imleci (id)"}],"responses":{"200":{"description":"Başarılı JSON yanıt","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Bulunamadı"},"429":{"description":"Hız sınırı aşıldı (240/dk)"}}}}}}