> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /openrice/restaurants/search

> Search OpenRice restaurants in a regional market with the full site filter surface: free-text what/where query, districts, landmarks and malls, cuisines, dishes, restaurant types, dining themes, features, accepted payment methods, cuisine/dish groups, seasonal promotions, spending tiers, offer types, OpenRice services, operating status, a reference point to rank by distance, and sort order. Returns restaurant cards with names, address, postal code, district, geo coordinates, weekly opening hours, rating and smile/ok/cry counts, cuisines, dishes, recommended dishes, price tier, photos, videos, chart badges and engagement counters. Results are the editorial listing only — sponsored placements the website shows alongside it are not part of the response.

**Price:** 1 credit



## OpenAPI

````yaml /openapi/local-places.json post /api/openrice/restaurants/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/openrice/restaurants/search:
    post:
      tags:
        - /openrice
      summary: /openrice/restaurants/search
      description: >-
        Search OpenRice restaurants in a regional market with the full site
        filter surface: free-text what/where query, districts, landmarks and
        malls, cuisines, dishes, restaurant types, dining themes, features,
        accepted payment methods, cuisine/dish groups, seasonal promotions,
        spending tiers, offer types, OpenRice services, operating status, a
        reference point to rank by distance, and sort order. Returns restaurant
        cards with names, address, postal code, district, geo coordinates,
        weekly opening hours, rating and smile/ok/cry counts, cuisines, dishes,
        recommended dishes, price tier, photos, videos, chart badges and
        engagement counters. Results are the editorial listing only — sponsored
        placements the website shows alongside it are not part of the response.


        **Price:** 1 credit
      operationId: __api_openrice_restaurants_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenriceRestaurantsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OpenriceRestaurantCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    OpenriceRestaurantsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        region:
          $ref: '#/components/schemas/OpenriceRegion'
          default: hongkong
        lang:
          $ref: '#/components/schemas/OpenriceLang'
          default: en
        keyword:
          anyOf:
            - type: string
            - type: 'null'
        where:
          anyOf:
            - type: string
            - type: 'null'
        district_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        cuisine_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        dish_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        amenity_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        theme_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        condition_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        payment_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        category_group_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        promotion_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        price_ranges:
          anyOf:
            - items:
                $ref: '#/components/schemas/OpenricePriceRange'
              type: array
            - type: 'null'
        offers:
          anyOf:
            - items:
                $ref: '#/components/schemas/OpenriceOffer'
              type: array
            - type: 'null'
        services:
          anyOf:
            - items:
                $ref: '#/components/schemas/OpenriceService'
              type: array
            - type: 'null'
        statuses:
          anyOf:
            - items:
                $ref: '#/components/schemas/OpenriceRestaurantStatus'
              type: array
            - type: 'null'
        latitude:
          anyOf:
            - type: number
              maximum: 90
              minimum: -90
            - type: 'null'
        longitude:
          anyOf:
            - type: number
              maximum: 180
              minimum: -180
            - type: 'null'
        sort:
          $ref: '#/components/schemas/OpenriceSort'
          default: overall_rating
        count:
          type: integer
          maximum: 10000
          minimum: 1
        landmark_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
      type: object
      required:
        - count
    OpenriceRestaurantCard:
      properties:
        '@type':
          type: string
          default: OpenriceRestaurantCard
        id:
          type: integer
        url:
          type: string
        alias:
          anyOf:
            - type: string
            - type: 'null'
        name:
          type: string
        name_other_lang:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        address_other_lang:
          anyOf:
            - type: string
            - type: 'null'
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
        district:
          anyOf:
            - $ref: '#/components/schemas/OpenriceDistrict'
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        mall_name:
          anyOf:
            - type: string
            - type: 'null'
        floor:
          anyOf:
            - type: string
            - type: 'null'
        unit:
          anyOf:
            - type: string
            - type: 'null'
        phones:
          items:
            type: string
          type: array
          default: []
        phone_remarks:
          items:
            type: string
          type: array
          default: []
        website:
          anyOf:
            - type: string
            - type: 'null'
        opened_at:
          anyOf:
            - type: integer
            - type: 'null'
        opening_hours:
          items:
            $ref: '#/components/schemas/OpenriceWeekHours'
          type: array
          default: []
        rating:
          anyOf:
            - type: number
            - type: 'null'
        or_score:
          anyOf:
            - type: number
            - type: 'null'
        smile_count:
          anyOf:
            - type: integer
            - type: 'null'
        cry_count:
          anyOf:
            - type: integer
            - type: 'null'
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
        photo_count:
          anyOf:
            - type: integer
            - type: 'null'
        restaurant_photo_count:
          anyOf:
            - type: integer
            - type: 'null'
        media_count:
          anyOf:
            - type: integer
            - type: 'null'
        bookmark_count:
          anyOf:
            - type: integer
            - type: 'null'
        price_range_id:
          anyOf:
            - type: integer
            - type: 'null'
        cuisines:
          items:
            $ref: '#/components/schemas/OpenriceCategory'
          type: array
          default: []
        dishes:
          items:
            $ref: '#/components/schemas/OpenriceCategory'
          type: array
          default: []
        recommended_dishes:
          items:
            type: string
          type: array
          default: []
        promotions:
          items:
            $ref: '#/components/schemas/OpenricePromotion'
          type: array
          default: []
        badges:
          items:
            type: string
          type: array
          default: []
        payment_ids:
          items:
            type: integer
          type: array
          default: []
        image:
          anyOf:
            - type: string
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
        videos:
          items:
            $ref: '#/components/schemas/OpenriceVideo'
          type: array
          default: []
        status:
          anyOf:
            - type: integer
            - type: 'null'
        status_text:
          anyOf:
            - type: string
            - type: 'null'
        moved_to_restaurant_id:
          anyOf:
            - type: integer
            - type: 'null'
        is_open_now:
          type: boolean
          default: false
        is_new:
          type: boolean
          default: false
        is_queuing_enabled:
          type: boolean
          default: false
        has_offer:
          type: boolean
          default: false
        has_premium_menu:
          type: boolean
          default: false
        distance:
          anyOf:
            - type: number
            - type: 'null'
        short_url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
        - url
        - name
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    OpenriceRegion:
      type: string
      enum:
        - hongkong
        - macau
        - shenzhen
        - guangzhou
        - zhuhai
        - dongguan
        - foshan
        - zhongshan
        - taipei
        - newtaipei-keelung
        - taoyuan
        - hsinchu-miaoli
        - taichung
        - changhua-nantou
        - yunlin-chiayi
        - tainan
        - kaohsiung-pingtung
        - eastern
        - tokyo-kanto
        - osaka-kobe
        - kyoto-kinki
        - nagoya-chubu
        - hokkaido
        - tohoku
        - hiroshima-chugoku
        - shikoku
        - fukuoka-kyushu
        - okinawa
        - bangkok
        - chonburi
        - phuket
        - prachuapkhirikhan
        - chiangmai
        - suratthani
        - nakhonratchasima
        - chiangrai
        - others
        - singapore
        - manila
    OpenriceLang:
      type: string
      enum:
        - en
        - tc
        - sc
        - tc-tw
        - ja
        - th
        - id
    OpenricePriceRange:
      type: string
      enum:
        - tier_1_cheapest
        - tier_2
        - tier_3
        - tier_4
        - tier_5
        - tier_6_most_expensive
    OpenriceOffer:
      type: string
      enum:
        - booking_offer
        - prepaid_booking_menu
        - premium_booking_menu
        - voucher
        - coupon
    OpenriceService:
      type: string
      enum:
        - online_booking
        - queuing
        - openrice_pay
    OpenriceRestaurantStatus:
      type: string
      enum:
        - operating
        - closed
        - changed_hands
        - under_renovation
        - moved
        - delisted
        - hidden
    OpenriceSort:
      type: string
      enum:
        - overall_rating
        - most_smiles
        - most_cries
        - most_reviews
        - most_bookmarked
        - highest_total_score
        - spending_low_to_high
        - spending_high_to_low
        - distance
    OpenriceDistrict:
      properties:
        '@type':
          type: string
          default: OpenriceDistrict
        id:
          type: integer
        name:
          type: string
        alias:
          anyOf:
            - type: string
            - type: 'null'
        group_id:
          anyOf:
            - type: integer
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
      type: object
      required:
        - id
        - name
    OpenriceWeekHours:
      properties:
        '@type':
          type: string
          default: OpenriceWeekHours
        day_of_week:
          anyOf:
            - type: integer
            - type: 'null'
        times:
          items:
            type: string
          type: array
          default: []
        is_open_24h:
          type: boolean
          default: false
        is_closed:
          type: boolean
          default: false
        is_holiday:
          type: boolean
          default: false
        is_holiday_eve:
          type: boolean
          default: false
      type: object
    OpenriceCategory:
      properties:
        '@type':
          type: string
          default: OpenriceCategory
        id:
          type: integer
        name:
          type: string
        alias:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
        - name
    OpenricePromotion:
      properties:
        '@type':
          type: string
          default: OpenricePromotion
        id:
          type: integer
        name:
          type: string
        terms:
          anyOf:
            - type: string
            - type: 'null'
        is_credit_card:
          type: boolean
          default: false
      type: object
      required:
        - id
        - name
    OpenriceVideo:
      properties:
        '@type':
          type: string
          default: OpenriceVideo
        id:
          type: integer
        video_url:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        caption:
          anyOf:
            - type: string
            - type: 'null'
        width:
          anyOf:
            - type: integer
            - type: 'null'
        height:
          anyOf:
            - type: integer
            - type: 'null'
        view_count:
          anyOf:
            - type: integer
            - type: 'null'
        like_count:
          anyOf:
            - type: integer
            - type: 'null'
        comment_count:
          anyOf:
            - type: integer
            - type: 'null'
        submitted_at:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
      required:
        - id
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````