restorans API

Base URL

https://restaurantsistanbul.vercel.app

Endpoints

Query Parameters — /api/restaurants

Example 1 — Budget-Friendly, Highly Rated

Request:

curl -X GET \
  "https://restaurantsistanbul.vercel.app/api/restaurants?city=istanbul&maxPrice=2&minRating=4.5&limit=5" \
  -H "X-RapidAPI-Key: YOUR_API_KEY"

Response:

{
  "meta": {
    "total": 123,
    "page": 1,
    "limit": 5,
    "total_pages": 25,
    "has_next": true,
    "last_updated": "2026-04-11"
  },
  "data": [
    {
      "id": "hamdi",
      "slug": "hamdi",
      "url": "https://restaurantsistanbul.vercel.app/istanbul/hamdi",
      "name": "Hamdi Restaurant",
      "neighborhood": "Eminönü",
      "cuisine": "Kebap",
      "price_range": 2,
      "avg_rating": 4.7,
      "review_count": 8432,
      "llm_summary": "Hamdi Restaurant in Eminönü has served classic kebap with Golden Horn views since 1969, one of Istanbul's most celebrated dining institutions.",
      "popular_dishes": ["Fıstıklı kebap", "İskender", "Lahmacun"],
      "features": {
        "terrace": true,
        "reservation": true,
        "seaView": true
      },
      "nearby": {
        "transit": [
          { "name": "Sirkeci", "type": "train", "walk_min": 3 },
          { "name": "Eminönü", "type": "ferry", "walk_min": 5 }
        ]
      },
      "confidence_score": 0.95,
      "verified_data": true
    }
  ]
}

Example 2 — Single Restaurant Detail

Request:

curl -X GET \
  "https://restaurantsistanbul.vercel.app/api/restaurants/hamdi" \
  -H "X-RapidAPI-Key: YOUR_API_KEY"

Response:

{
  "meta": { "source": "restorans", "last_updated": "2026-04-11" },
  "data": {
    "id": "hamdi",
    "name": "Hamdi Restaurant",
    "cuisine": "Kebap",
    "price_range": 2,
    "avg_rating": 4.7,
    "llm_summary": "Hamdi Restaurant in Eminönü has served classic kebap with Golden Horn views since 1969.",
    "sentiment_summary": "Guests consistently praise the fıstıklı kebap and the panoramic terrace views.",
    "faq": [
      { "question": "Is a reservation required?", "answer": "Reservations are recommended on weekends." },
      { "question": "Where is the nearest metro?", "answer": "Sirkeci train station is a 3-minute walk away." }
    ],
    "contextual_ratings": {
      "businessLunch": 4,
      "romanticDate": 4,
      "familyDining": 5,
      "soloVisit": 4,
      "groupDining": 5
    },
    "scenario_summary": {
      "tourist": "A classic Istanbul institution that every visitor should experience at least once.",
      "family": "Ideal for family meals with its spacious layout and varied menu.",
      "romantic": "Well-suited for romantic dinners on the terrace overlooking the Golden Horn."
    },
    "nearby": {
      "transit": [
        { "name": "Sirkeci", "type": "train", "walk_min": 3 },
        { "name": "Eminönü", "type": "ferry", "walk_min": 5 }
      ],
      "landmarks": [
        { "name": "Spice Bazaar", "walk_min": 4 },
        { "name": "Yeni Cami", "walk_min": 2 }
      ]
    }
  }
}

Example 3 — Fish in Kadıköy

Request:

curl -X GET \
  "https://restaurantsistanbul.vercel.app/api/restaurants?city=istanbul&neighborhood=kadikoy&cuisine=balik" \
  -H "X-RapidAPI-Key: YOUR_API_KEY"

What Each Record Contains