🔌 Açık API ve gömme

Kimlik doğrulaması yok · CORS açık · 5 dakika önbellek

TrendMatik sıralamaları herkese açıktır. Aşağıdaki uçlardan JSON olarak çekebilir ya da listeleri kendi sitenize gömebilirsiniz. Tek ricamız kaynak olarak TrendMatik'e bağlantı vermeniz.

Uçlar

GET /api/genel/listeler

Yayındaki tüm listelerin dizini: slug, başlık, kategori, şehir ve her liste için veri/gömme adresleri.

curl https://www.trendmatik.com/api/genel/listeler

GET /api/genel/liste/{slug}

Tek bir listenin güncel sıralaması: sıra, ad, puan, oy sayısı, günlük değişim, görsel ve site adresi.

curl https://www.trendmatik.com/api/genel/liste/istanbul-da-trend-kahve-mekanlari

GET /api/genel/madde/{slug}

Bir maddenin (işletme, ürün, site…) yer aldığı tüm listeler ve her birindeki sırası. Kendi sıranı kendi sitende göstermek için.

curl https://www.trendmatik.com/api/genel/madde/trendyol

GET /api/genel/gunun

Günün özeti: en çok yükselen 5 liste (zirvedeki üçlü ve değişimle) ve günün bulmacası. Bot, bülten ve panolar için tek istek.

curl https://www.trendmatik.com/api/genel/gunun

GET /api/genel/openapi.json

OpenAPI 3.1 tanımı — Postman, Swagger UI ya da yapay zekâ ajanlarına doğrudan verin.

curl https://www.trendmatik.com/api/genel/openapi.json

RSS beslemeleri

/feed.xml — site geneli: sıralanmış listeler ve blog yazıları
/kategori/{slug}/feed.xml — kategori
/liste/{slug}/feed.xml — tek liste, madde başına öğe
/blog/feed.xml — blog

Madde rozeti

Sıralamada yer alan bir işletme ya da site, sırasını kendi sayfasında <img> olarak gösterebilir. Görsel canlıdır; sıra değişince rozet de değişir.

<a href="https://www.trendmatik.com/madde/madde-slug">
  <img src="https://www.trendmatik.com/rozet/liste-slug/madde-slug" width="260" height="56"
       alt="TrendMatik'te 1. sırada" loading="lazy">
</a>

Hazır kod her madde sayfasının altında ("Rozet" bölümü). ?tema=gece koyu zemin.

Gömme

Her listenin sayfasında "Bu listeyi sitene göm" düğmesi hazır kodu üretir. Elle yazmak isterseniz:

<iframe
  src="https://www.trendmatik.com/gomulu/liste-slug?adet=5&tema=gece"
  width="100%" height="290" style="border:0" loading="lazy"
  title="TrendMatik listesi"></iframe>

adet: 3–10 arası madde sayısı (varsayılan 10) · tema: gece verilirse koyu görünüm. Gömülü liste sıralama değiştikçe kendiliğinden güncellenir.

Sınırlar

Yanıtlar 5 dakika kenar önbelleğinde tutulur; daha sık çekmek yeni veri getirmez.
Yalnızca onaylanmış listeler ve yayındaki maddeler döner.
Yazma ucu yoktur — oy vermek için site üzerinden gelin.

Bir sorun mu var, farklı bir uca mı ihtiyacınız var? Bize yazın.