Asian Recs

Find places in San Francisco or New York ranked by how Asian diners rate them. Each result has the Asian diners' rating, everyone else's rating, the gap between them, how many Asian diners reviewed it, top dishes, neighborhood and a link to its page.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "sf",
        "nyc"
      ],
      "description": "sf = San Francisco, nyc = New York"
    },
    "type": {
      "description": "Kind of place. Default restaurants.",
      "type": "string",
      "enum": [
        "restaurants",
        "desserts",
        "cafes",
        "bars"
      ]
    },
    "cuisine": {
      "description": "Cuisine or drink category, e.g. \"ramen\", \"sichuan\", \"korean\", \"boba\", \"dim sum\".",
      "type": "string"
    },
    "location": {
      "description": "Neighborhood or area, e.g. \"Mission\", \"East Village\", \"Flushing\", \"Manhattan — Downtown\".",
      "type": "string"
    },
    "query": {
      "description": "Free text matched against name, cuisine, neighborhood and dishes, e.g. a dish like \"soup dumplings\".",
      "type": "string"
    },
    "near": {
      "description": "A point to measure distance from; adds distance_mi to results.",
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        }
      },
      "required": [
        "lat",
        "lng"
      ]
    },
    "radius_mi": {
      "description": "With near: only places within this many miles.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "sort": {
      "description": "asian_rating: Asian diners' rating, highest first; loved_more: Biggest gap above everyone else; most_asian_diners: Most Asian diners; share_asian: Highest share of Asian reviewers; distance: Closest first (needs near). Default asian_rating.",
      "type": "string",
      "enum": [
        "asian_rating",
        "loved_more",
        "most_asian_diners",
        "share_asian",
        "distance"
      ]
    },
    "limit": {
      "description": "Default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "city"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Full Asian Recs page for one place: both ratings and the gap, share of reviewers who are Asian, dishes Asian diners mention most, quotes from Asian diners, Google and Yelp ratings, and links (Asian Recs, Google Maps, Yelp, Instagram).

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "sf",
        "nyc"
      ],
      "description": "sf = San Francisco, nyc = New York"
    },
    "name": {
      "type": "string",
      "description": "Place name; partial names work."
    },
    "type": {
      "description": "Narrow to one kind of place when a name is ambiguous.",
      "type": "string",
      "enum": [
        "restaurants",
        "desserts",
        "cafes",
        "bars"
      ]
    }
  },
  "required": [
    "city",
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Areas, neighborhoods and cuisines available for a city and kind of place, with how many ranked places each has.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "enum": [
        "sf",
        "nyc"
      ],
      "description": "sf = San Francisco, nyc = New York"
    },
    "type": {
      "description": "Kind of place. Default restaurants.",
      "type": "string",
      "enum": [
        "restaurants",
        "desserts",
        "cafes",
        "bars"
      ]
    }
  },
  "required": [
    "city"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}