🔌 Developer API v1

With BOZFIX Open API, you can bring Antalya service data (categories, verified pros, price ranges) to your own app. It's read-only and public data — no personal or sensitive information is shared.

🔑 Identity & Limit

API key is required for every request. You can send it in two ways:

https://bozfix.com/api/v1.php?kaynak=kategoriler&anahtar=ANAHTARINIZ

# or with title:curl -H "X-API-Key: ANAHTARINIZ" "https://bozfix.com/api/v1.php?kaynak=kategoriler"

You can retrieve your key from your account yourself. Daily request limit is defined for your key (if exceeded, HTTP 429). Get my API key →

📚 Tips

SourceParametersRotating
?kaynak=kategoriler Active service categories (id, name, slug, icon)
?kaynak=ustalar ilce, kategori, limit Verified pros (name, rating, trust score, profile link)
?kaynak=usta slug Single pro's details (experience, rating, completed work)
?kaynak=fiyat kategori, ilce Category/district price range (from completed actual work)
?kaynak=surum API version + source list (keyless — discovery)

🔎 Discover (no keywords)

GET https://bozfix.com/api/v1.php?kaynak=surum

{
  "ok": true,
  "surum": "v1",
  "durum": "aktif",
  "kaynaklar": ["kategoriler","ustalar","usta","fiyat"],
  "kimlik": "?anahtar= veya X-API-Key başlığı"
}

Release endpoint doesn't require an API key — you're free to call it to explore the API. All responses are JSON, UTF-8. In case of error {"ok":false,"hata":"..."}.

🤖 AI Agents (MCP)

BOZFIX offers an MCP (Model Context Protocol) server that enables AI assistants (ChatGPT, Claude, etc.) to communicate directly with the site. Your assistant can query categories, certified pros, and price ranges through this endpoint; it can prepare request drafts on your behalf.

POST https://bozfix.com/api/mcp.php
# JSON-RPC 2.0 / Streamable HTTP (single POST endpoint)
ToolFunction
kategoriler Lists active service categories
usta_ara Searches and lists verified pros
fiyat_tahmini Provides price range from real work
talep_olustur Opens approval-model service request
talep_taslak_olustur Prepares service request draft with short link
talep_durum Checks the status of an opened request
bolge_kapsama Checks if there's service coverage in the district
randevu_musaitlik Shows pro's busy hours

Read tools are keyless; request creation is approval-based — requests don't go to pros until you click the confirmation link.

To add to ChatGPT: Settings → Connectors (Connectors) → MCP server, follow the steps and enter the endpoint above.
To add to Claude: Settings → Connectors → custom connector, follow the steps and enter the endpoint above.

Get my API key →

← Back to Home

💬
💬