Developer

API Documentation

The Tarım İklim service layer is REST-based and returns JSON. Use the examples below to test live forecasts, frost-risk data and widget integration quickly.

Base URL

https://tarimiklim.com/api/v1

Format

JSON (UTF-8)

Rate Limit

60 requests / minute (free tier)

GET/weather?lat=36.89&lon=30.68&days=7

Returns 7-day forecast data.

curl "https://tarimiklim.com/api/v1/weather?lat=36.89&lon=30.68&days=7"

GET/weather/current?lat=36.89&lon=30.68

Returns current weather data.

curl "https://tarimiklim.com/api/v1/weather/current?lat=36.89&lon=30.68"

GET/weather/frost-risk?lat=36.89&lon=30.68

Returns the frost-risk score and risk days.

curl "https://tarimiklim.com/api/v1/weather/frost-risk?lat=36.89&lon=30.68"

GET/weather/hourly?lat=36.89&lon=30.68&slots=8

Returns near-term forecasts in 3-hour slots.

curl "https://tarimiklim.com/api/v1/weather/hourly?lat=36.89&lon=30.68&slots=8"

GET/weather/widget-data?location=antalya-merkez

Returns a lightweight payload optimized for widgets.

curl "https://tarimiklim.com/api/v1/weather/widget-data?location=antalya-merkez"

POST/alerts/subscribe

Example notification subscription endpoint for integration flows.

curl -X POST "https://tarimiklim.com/api/v1/alerts/subscribe" \
  -H "Content-Type: application/json" \
  -d '{"location":"antalya-merkez","channel":"telegram","threshold":65}'

Widget Integration

You can embed the widget component with an iframe. In the example below, the live endpoint is served directly through this project.

<iframe
  src="https://tarimiklim.com/tr/widget/bereketfide"
  width="360"
  height="210"
  style="border:none;border-radius:14px"
  title="Tarımİklim Widget"
/>