# Turkpidya

> Turkpidya is a Turkey-focused encyclopedia and live-data platform by Pidya Group:
> articles on Turkish history, culture, cities, travel and economy in 18 languages,
> plus a free public JSON API for live Turkey data (gold prices, exchange rates,
> fuel prices, prayer times, earthquakes).

## Turkey Data API

- [Developer documentation](https://turkpidya.com/developers/): quickstart, full endpoint reference, rate limits and terms
- Base URL: https://turkpidya.com/wp-json/turkpidya-data/v1/
- Free, no API key, read-only GET, JSON responses, 60 requests/min per IP
- Attribution required when republishing data: link to https://turkpidya.com
- Commercial / high-volume access: info@pidyagroup.com

### Endpoints

- [Gold & silver prices](https://turkpidya.com/wp-json/turkpidya-data/v1/gold): current Turkish gold/silver prices in TRY (gram 14k-24k, coins, silver), refreshed every 5 minutes
- [Exchange rates](https://turkpidya.com/wp-json/turkpidya-data/v1/fx): official TCMB central-bank TRY rates for 22 currencies, updated each trading day ~15:35 TRT; single currency at /fx/{code}
- [Earthquakes](https://turkpidya.com/wp-json/turkpidya-data/v1/earthquakes): recent quakes in/around Turkey from Kandilli Observatory (KOERI), polled every 5 minutes; latest event at /earthquakes/latest
- [Prayer times](https://turkpidya.com/wp-json/turkpidya-data/v1/prayer-times?city=istanbul): daily prayer times for 20 Turkish cities, Diyanet method; city list at /prayer-times/cities
- [Fuel prices](https://turkpidya.com/wp-json/turkpidya-data/v1/fuel): pump prices per litre (benzin95, motorin) by city from EPDK reports, refreshed every 6 hours
- [Medication lookup](https://turkpidya.com/wp-json/turkpidya-data/v1/meds/lookup?q=Doliprane): find licensed Turkish equivalents of foreign medications by brand or active ingredient (TİTCK & SGK datasets, SGK equivalence groups, honest not-available verdicts); typeahead at /meds/suggest?q=. Information only — not medical advice.

## MCP Server

- [turkey-data-mcp](https://github.com/bodyegypt/turkey-data-mcp): open-source MCP server (MIT) exposing this API to AI assistants as 7 tools (gold, FX, fuel, prayer times, earthquakes)
- Install: `claude mcp add turkey-data -- npx -y turkey-data-mcp` (Node.js >= 18; until the npm listing is live use `npx -y github:bodyegypt/turkey-data-mcp`)

## Site

- [Home](https://turkpidya.com/): Turkey encyclopedia in 18 languages
- [Medication lookup tool](https://turkpidya.com/meds/): web interface for the medication equivalence endpoint
- [About](https://turkpidya.com/about/): what Turkpidya is
- [Contact](https://turkpidya.com/contact/): get in touch, or email info@pidyagroup.com

## Notes

- Data is aggregated from official/public Turkish sources (TCMB, EPDK, Kandilli/KOERI, Diyanet-method via Aladhan, Harem Altın) and provided as-is, without warranty.
- Every API response includes a `last_updated` ISO-8601 timestamp (Europe/Istanbul) and Cache-Control headers; please cache accordingly.