📡 İŞKO REST API

Türkiye'deki tüm işletme verilerine programatik erişin. JSON, basit HTTP, güvenilir altyapı.

🔑 API Anahtarınız

API anahtarı almak için bir paket satın alın veya giriş yapın.

💰 API Planları

🔐 Kimlik Doğrulama

Her istekte API anahtarınızı X-Api-Key header'ı veya ?key= parametresi ile gönderin.

curl -H "X-Api-Key: isko_your_key_here" \
     "https://iskob2b.com.tr/v1/search?city=istanbul§or=restoran"

📋 Endpoint Referansı

GET /v1/search?city=istanbul§or=restoran&limit=20

# Yanıt:
{
  "ok": true,
  "total_found": 847,
  "returned": 20,
  "city": "istanbul",
  "sector": "restoran",
  "plan": "pro",
  "remaining_today": 498,
  "data": [
    {
      "name": "Lezzet Restoran",
      "address": "Kadıköy, İstanbul",
      "phone": "0216 123 4567",
      "website": "lezzetrestoran.com",
      "emails": ["info@lezzetrestoran.com"],
      "email_source": "scraped",
      "rating": 4.5,
      "reviews": 312,
      "lead_score": 78,
      "socials": {
        "instagram": "https://instagram.com/lezzetrestoran"
      }
    }
  ]
}

GET /v1/status

{
  "ok": true,
  "plan": "pro",
  "daily_limit": 500,
  "calls_today": 2,
  "remaining_today": 498,
  "total_calls": 1847
}

💻 Kod Örnekleri

Python

import requests

headers = {"X-Api-Key": "isko_your_key_here"}
resp = requests.get(
    "https://iskob2b.com.tr/v1/search",
    params={"city": "ankara", "sector": "guzellik salonu", "limit": 50},
    headers=headers
)
data = resp.json()
for biz in data["data"]:
    print(biz["name"], biz.get("phone"), biz.get("emails"))

JavaScript / Node.js

const resp = await fetch(
  'https://iskob2b.com.tr/v1/search?city=izmir§or=insaat&limit=20',
  { headers: { 'X-Api-Key': 'isko_your_key_here' } }
);
const { data } = await resp.json();
data.forEach(b => console.log(b.name, b.phone));

PHP

$ch = curl_init('https://iskob2b.com.tr/v1/search?city=istanbul§or=teknoloji&limit=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Api-Key: isko_your_key_here']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
foreach ($data['data'] as $biz) {
    echo $biz['name'] . ' — ' . $biz['phone'] . "\n";
}

⚠️ Hata Kodları