Free Türkiye data API
Gold prices, lira exchange rates, earthquakes, prayer times, fuel and duty pharmacies, through a simple web link, as JSON.
GET /gold?category=gram{
"type": "gram_24k",
"sell": 6570.12,
"price_date": "2026-11-05",
"attribution": {
"text": "Data: Turkpidya"
}
}Live data
Tap a card to try it right below.
GET /fx/USD
GET /gold?category=gram
GET /fuel?city=istanbul
GET /earthquakes
GET /prayer-times?city=istanbul
GET /pharmacies/on-duty
GET /meds/lookup?q=…
Your first request
Pick a topic, then ask for the data. Switch between a friendly explanation and the exact answer a program receives.
TCMB lira exchange rates for dollars, euros and other currencies. Useful for a travel budget or an invoice.
This makes a real, read-only request.
Where it comes fromTCMB, Türkiye’s central bank
Press “Get the data” to see what comes back.
No setup. No code. Just try it.
Make a request to see the JSON response.This code asks the same question as the explorer above. If a browser blocks a request from your own website, run it on your server.
The one rule
The API is free. All we ask in return is a visible link wherever the data appears.
attribution field: the text, a tagged address and HTML to paste.web_url is the Turkpidya page with the same data. Add ?lang=xx to get it in another language.<a href="https://turkpidya.com/gold-prices/">Data: Turkpidya</a>No code
Paste two lines and a live gold, exchange rate, earthquake, prayer time or duty pharmacy box appears. The credit link stays in your own page.
The box refreshes itself every 5 minutes. Please keep the credit link: it is the one condition that keeps the data free.
Optional
Calls without a key keep working. A key gives you:
Send it with each call as ?key=... or in an X-API-Key header.
Showcase
Apps and sites that show the credit link. Yours could be here too.
The data collection
Inflation, rent caps, minimum wage and tax brackets, house prices, tourism, motorway and bridge tolls, museums. Each with its current revision, history and schema. OpenAPI file (every address)
calendar-eventscpiearthquake-statsearthquakeseconomic-seriesenergy-pricesfood-cpifuel-brandsfuel-historyfx-historyfx-rateshousing-indexinternational-wagesmarket-historymuseum-passesmuseumspayroll-parameterspharmaciesprayer-timesprovincesrent-rulesroutestollstourism-entriestourism-receiptsGET /fxGET /fx/{currency}Update schedule: Each business day, around 15:30 · Reuse an answer for: 1 hour
These are central-bank reference rates. A bank or exchange office may offer a different rate.
Open this API address GET /goldUpdate schedule: Every 5 minutes · Reuse an answer for: 5 minutes
Buy and sell are separate prices. All amounts are in Turkish lira; check the record date before using them. Each price names its source.
Open this API address GET /prayer-timesGET /prayer-times/citiesUpdate schedule: Daily · Reuse an answer for: Until midnight
A local mosque’s timetable may differ by a few minutes.
Open this API address GET /fuelUpdate schedule: Every 6 hours · Reuse an answer for: 1 hour
The answer gives city averages, not a guaranteed price at a particular station.
Open this API address GET /earthquakesGET /earthquakes/latestUpdate schedule: Every 5 minutes · Reuse an answer for: 5 minutes
This is a record of reported events, not an emergency alert service.
Open this API address GET /pharmacies/on-dutyUpdate schedule: Hourly · Reuse an answer for: Up to 5 minutes
Call the pharmacy before you go. In an emergency, dial 112.
Open this API address GET /meds/lookupGET /meds/suggestUpdate schedule: Weekly (Sunday) · Reuse an answer for: 1 hour
Matching an ingredient does not mean two medicines can be safely substituted. Always confirm with a pharmacist.
Open this API address All addresses start with https://turkpidya.com/wp-json/turkpidya-data/v1. Existing turkpidya-gold/v1 and turkpidya-earthquake/v1 integrations still work.
For curious humans and helpful AI
Connect Turkpidya to an AI assistant that supports MCP. Then ask a normal question, and it can look up the answer using these same data sources.
Every answer includes web_url, so the assistant can show its source as a link.
“Can you check the euro exchange rate for me?”
It can read the rate, name the source, and tell you the date of the record.
Requires Node.js 18+ and Claude Code. Run this in your terminal:
claude mcp add turkey-data -- npx -y turkey-data-mcpGood to know
A few simple rules keep the service useful for everyone.
Up to 60 requests per minute per IP (300 with a free key). If you receive 429, pause for the seconds in the Retry-After header before trying again.
Follow the Cache-Control header. Always check the date in the answer: a successful request can still return an older record.
When you show the data publicly, add a visible link to Turkpidya. Please don’t resell the raw feeds or repeatedly request the same data.
A way for one program to ask another for information. Here, the question is a web address and the answer is data about Türkiye.
The address for one kind of information. For example, /gold asks for gold prices and /fx/USD asks for the dollar exchange rate.
Text organised with labels. In "currency": "TRY", the label is currency and the value is TRY. Your app can read each value separately.
A request to read information. All the addresses on this page use GET. Asking for data does not change it.
A saved answer you reuse for a while. It makes your app faster and avoids asking for the same information repeatedly.
The maximum number of requests allowed in a period. The public API allows up to 60 per minute per IP address, 300 with a free key.
A browser permission that lets a page on another website request this API. This API allows every site.
A shared way to connect AI assistants to tools. The Turkpidya MCP server lets a compatible assistant ask this API for information.
A date and time attached to a record. For example, +03:00 at the end means the time is three hours ahead of UTC, as in Istanbul.
A short number explaining the result of a request. 200 means it worked; 404 means the requested record was not found; 429 means wait before trying again.
Empty answer: no records are available for that request. Check any note and the source date. 400: check your filters. 404: the requested record or date is unavailable. 429: wait before trying again. 503: the service or dataset is temporarily unavailable.
Use the API in apps, research and personal projects within these limits. Data is provided as available, without a guarantee of freshness or uptime. It is not financial, medical or emergency advice.
Need higher limits, historical data or a service agreement? Talk to us at [email protected]