API بانک اطلاعات مشاغل

روند کار در ۲ درخواست

1. POST /api/v1/searches: جستجو را ثبت کنید (صنف، شهر یا محدوده، تعداد). پاسخ فوری است.
2. GET /api/v1/searches/{id}/leads: سرنخ‌ها را به صورت JSON بگیرید.

هر سرنخ نام، دسته‌بندی، تلفن، نشانی و لینک موقعیت مکانی دارد؛ وب‌سایت، شبکه‌های اجتماعی، ساعات کاری و امتیاز در اینترنت هرجا موجود باشد. پاسخ جستجو فوری است.

import requests

API = "https://kasbikav.ir/api/v1"
H = {"Authorization": "Bearer mm_live_..."}

s = requests.post(f"{API}/searches", headers=H, json={
    "kind": "area", "q": "دندانپزشکی", "city": "شیراز",
    "limit": 100}).json()

leads = requests.get(f"{API}/searches/{s['id']}/leads", headers=H).json()
for lead in leads["items"]:
    print(lead["name"], lead["phone"], lead["address"], lead["google_maps_url"])

نقاط دسترسی

خطاها به شکل {"error": {"code": "...", "message": "..."}} برمی‌گردند؛ مثلاً insufficient_funds (۴۰۲) یا rate_limited (۴۲۹). استفاده از API تابع قوانین و مقررات است و فروش یا نمایش داده‌های خام به دیگران ممنوع است.