Business Data API

SEMUST-API-USER: your_username
SEMUST-API-PASSWORD: your_password
Content-Type: application/json

{
  "type": "search",
  "categories": ["cafe"],
  "latitude": 40.9906,
  "longitude": 29.0270,
  "radius_km": 1,
  "limit": 20
}

{
  "type": "profile",
  "place_id": "ChIJQ3x3p-e5yhQRCzOLzD3Pdkw"
}

{
  "type": "reviews",
  "cid": "5509819058466009867",
  "sort": "newest",
  "limit": 50
}

curl -X POST https://data.semust.com/v1/business-data \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -H "Content-Type: application/json" \
  -d '{"type": "search", "categories": ["cafe"], "latitude": 40.9906, "longitude": 29.0270, "radius_km": 1, "limit": 20}'

import time
import requests

HEADERS = {
    "SEMUST-API-USER": "your_username",
    "SEMUST-API-PASSWORD": "your_password",
}

response = requests.post(
    "https://data.semust.com/v1/business-data",
    headers=HEADERS,
    json={"type": "reviews", "cid": "5509819058466009867", "sort": "newest", "limit": 50},
    timeout=90,  # longer than ?wait= (60 seconds by default)
)
data = response.json()

# Reviews take one to three minutes: expect 202 and poll.
# Never re-POST while waiting; that would be a second charge.
while response.status_code == 202:
    time.sleep(int(response.headers.get("Retry-After", data.get("retry_after", 5))))
    response = requests.get(data["poll_url"], headers=HEADERS, timeout=30)
    data = response.json()

if response.status_code != 200:
    raise SystemExit(f"{data['code']}: {data['error']} {data.get('hint', '')}")

print(data["business"]["name"], data["business"]["rating"])
for review in data["items"]:
    print(review["published_at"], review["rating"], (review["text"] or "")[:80])

{
  "success": true,
  "type": "search",
  "country": "TR",
  "total": 450,
  "count": 20,
  "page": 1,
  "limit": 20,
  "sort": "reviews",
  "direction": "desc",
  "items": [
    {
      "name": "Asuman Moda",
      "category": "Chocolate shop",
      "categories": ["chocolate_shop", "cafe"],
      "place_id": "ChIJX5XeCGG4yhQRH7cWWfY90-Q",
      "cid": "16488590788999427871",
      "address": "Caferağa, Şair Nefi Sk. No:9/a, 34710 Kadıköy/İstanbul",
      "neighborhood": "Caferağa",
      "city": "Kadıköy",
      "region": "İstanbul",
      "postal_code": "34710",
      "country": "TR",
      "phone": "+902163450526",
      "website": "http://www.asuman.com/",
      "domain": "www.asuman.com",
      "latitude": 40.9837234,
      "longitude": 29.026517,
      "rating": 4.1,
      "reviews": 8907,
      "rating_distribution": { "1": 879, "2": 402, "3": 753, "4": 1511, "5": 5362 },
      "price_level": null,
      "claimed": true,
      "photos": 4219,
      "maps_url": "https://www.google.com/maps?cid=16488590788999427871&hl=en&gl=TR",
      "updated_at": "2026-09-21T08:36:30Z"
    }
  ],
  "cost": 0.02112,
  "cached": false,
  "request_id": "0b7e6f1a-3c2d-4e5f-9a8b-1c2d3e4f5a6b"
}

{
  "success": true,
  "type": "profile",
  "country": "TR",
  "language": "tr",
  "data": {
    "name": "Galata Kulesi",
    "category": "Tarihi Yer",
    "categories": ["Tarihi Yer", "Turistik Yer"],
    "place_id": "ChIJQ3x3p-e5yhQRCzOLzD3Pdkw",
    "cid": "5509819058466009867",
    "address": "Bereketzade, 34421 Beyoğlu/İstanbul",
    "neighborhood": "Bereketzade",
    "city": "Beyoğlu",
    "region": "İstanbul",
    "postal_code": "34421",
    "country": "TR",
    "phone": "+902122490344",
    "website": "https://galatakulesi.gov.tr/",
    "domain": "galatakulesi.gov.tr",
    "latitude": 41.025569,
    "longitude": 28.9741286,
    "rating": 4.6,
    "reviews": 219004,
    "rating_distribution": { "1": 3922, "2": 2572, "3": 11185, "4": 31764, "5": 169561 },
    "price_level": null,
    "claimed": true,
    "photos": 399916,
    "maps_url": "https://www.google.com/maps?cid=5509819058466009867",
    "updated_at": null,
    "description": "En üst katındaki restoranıyla boğaza tepeden bakan, restore edilmiş 14. yüzyıl kulesi ve eski zindan.",
    "open_now": "closed",
    "hours": {
      "monday": [{ "open": "08:30", "close": "22:00" }],
      "tuesday": [{ "open": "08:30", "close": "22:00" }]
    },
    "attributes": {
      "available": [],
      "unavailable": ["has_wheelchair_accessible_entrance"]
    },
    "topics": [],
    "people_also_search": []
  },
  "cost": 0.00594,
  "cached": false,
  "request_id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a"
}

{
  "success": true,
  "type": "reviews",
  "country": "TR",
  "language": "tr",
  "count": 50,
  "limit": 50,
  "sort": "newest",
  "business": {
    "name": "Galata Kulesi",
    "place_id": "ChIJQ3x3p-e5yhQRCzOLzD3Pdkw",
    "cid": "5509819058466009867",
    "rating": 4.6,
    "reviews": 219004
  },
  "items": [
    {
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xkSFJXRkJRVTAyVDNweVRIQXhkM0oxUm1oVGNYYxAB",
      "rating": 5,
      "text": "Müzekart ile ücretsiz giriş mevcut. İçeride asansör de var, en üst kata çıkabiliyorsunuz.",
      "original_text": null,
      "original_language": "tr",
      "published_at": "2026-10-20T17:29:15Z",
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7…",
      "images": 7,
      "author": {
        "name": "Ayşe Y.",
        "url": "https://www.google.com/maps/contrib/…/reviews",
        "reviews": 88,
        "photos": 113,
        "local_guide": true
      },
      "owner_answer": null
    }
  ],
  "cost": 0.004125,
  "cached": false,
  "request_id": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d"
}

{
  "error": "'cafee' is not a business category",
  "code": "UNKNOWN_CATEGORY",
  "field": "categories",
  "hint": "Did you mean 'cafe'? GET /v1/business-data/categories?q=… searches every category id",
  "retryable": false
}

{
  "error": "No business was found",
  "code": "BUSINESS_NOT_FOUND",
  "hint": "Check the name, add the city to it, or use place_id or cid from type=search. You were not charged",
  "retryable": false,
  "request_id": "1e2d3c4b-5a6f-4e7d-8c9b-0a1f2e3d4c5b"
}