API v1

B2B API Documentation

Access Japan's most comprehensive halal data through our REST API. Integrate restaurant listings, prayer room locations, product data, and tour packages into your application.

Base URL

https://halal-japan.kousuke-ito-316.workers.dev

Authentication

The API is currently in open beta. API key authentication will be required for production use.

Authorization: Bearer YOUR_API_KEY

Coming SoonRate limiting and usage tiers

Endpoints

GET/api/b2b/restaurants

Search and filter halal restaurants across Japan. Returns verified restaurant data including halal certification status, location, cuisine type, and ratings.

Parameters

citystringFilter by city (e.g., tokyo, osaka, kyoto)

cuisinestringFilter by cuisine type (e.g., japanese, indian, turkish)

certifiedbooleanFilter only halal-certified restaurants

limitnumberResults per page (default: 20, max: 100)

offsetnumberPagination offset

Response

{
  "data": [
    {
      "id": "rst_abc123",
      "name": "Halal Kitchen Tokyo",
      "name_ja": "ハラルキッチン東京",
      "city": "tokyo",
      "address": "1-2-3 Shinjuku, Shinjuku-ku, Tokyo",
      "lat": 35.6895,
      "lng": 139.6917,
      "cuisine": "japanese",
      "halal_grade": "fully_certified",
      "certification_body": "Japan Halal Association",
      "rating": 4.5,
      "review_count": 128,
      "updated_at": "2026-03-15T10:30:00Z"
    }
  ],
  "total": 2847,
  "limit": 20,
  "offset": 0
}

GET/api/b2b/prayer-rooms

Find prayer rooms and musholla facilities across Japan including airports, shopping centers, and public spaces.

Parameters

citystringFilter by city

typestringFilter by type (airport, mall, mosque, public)

latnumberLatitude for proximity search

lngnumberLongitude for proximity search

radiusnumberSearch radius in km (default: 5)

Response

{
  "data": [
    {
      "id": "prm_xyz789",
      "name": "Narita Airport Terminal 1 Prayer Room",
      "name_ja": "成田空港第1ターミナル礼拝室",
      "type": "airport",
      "city": "narita",
      "floor": "3F",
      "capacity": 15,
      "facilities": ["wudu", "qibla_compass", "prayer_mat"],
      "hours": "24/7",
      "lat": 35.7648,
      "lng": 140.3863
    }
  ],
  "total": 892,
  "limit": 20,
  "offset": 0
}

GET/api/tour-packages

Curated Muslim-friendly tour packages across Japan, with verified halal dining and prayer accommodations included.

Parameters

regionstringFilter by region (kanto, kansai, hokkaido, etc.)

durationnumberTour duration in days

budgetstringBudget tier (economy, standard, premium)

Response

{
  "data": [
    {
      "id": "tour_001",
      "title": "Tokyo & Mt. Fuji Halal Experience",
      "duration_days": 5,
      "regions": ["kanto"],
      "highlights": ["Asakusa", "Shibuya", "Mt. Fuji", "Hakone"],
      "halal_meals_included": true,
      "prayer_stops": 12,
      "price_from_usd": 1200,
      "tier": "standard"
    }
  ],
  "total": 24
}

GET/api/stats

Platform-wide statistics. Useful for dashboards and integrations showing data coverage.

Response

{
  "restaurants": 2847,
  "products": 15230,
  "prayer_rooms": 892,
  "languages": 8,
  "cities_covered": 47,
  "last_updated": "2026-03-24T00:00:00Z"
}

Need Custom Data?

We offer custom data feeds, bulk exports, and dedicated API plans for enterprise clients.

Contact Enterprise Sales