Open API

Listing businesses

GET /api/v1/businesses?q=coffee&city=Bursa&category=kafe

All parameters are optional. Each record includes country, location and profile languages.

Single business and location

GET /api/v1/businesses/{slug}
GET /api/v1/businesses/{slug}/location
GET /businesses.geojson

Returns details, services, hours, FAQ, photos, language versions, the full Schema.org graph and the location verification record.

Scan endpoints

POST /api/ai-test          { "url": "https://example.com" }
POST /api/security-test    { "url": "https://example.com" }

Open to everyone with an hourly limit per IP.

Usage rules

You may use the data with attribution (a link to kieosa.com). Bulk scraping and using it to send unsolicited messages to businesses is prohibited.