> ## 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/coupons/search

> Search OpenRice dining offers in a regional market: free restaurant coupons, paid cash vouchers, prepaid booking menus and merchant offers. Each offer returns its title, description, full terms and conditions, how to redeem it, artwork and dish photos, original and discounted price, discount type and value, remaining stock and sales counters, the validity window with the exact weekdays and time slots it can be used on plus the dates it is excluded on, and the restaurants it can be redeemed at. Filter by offer kind, keyword, restaurant, districts, landmarks, cuisines, dishes, restaurant types, category groups and seasonal promotions.

**Price:** 1 credit



## OpenAPI

````yaml /openapi/local-places.json post /api/openrice/coupons/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/coupons/search:
    post:
      tags:
        - /openrice
      summary: /openrice/coupons/search
      description: >-
        Search OpenRice dining offers in a regional market: free restaurant
        coupons, paid cash vouchers, prepaid booking menus and merchant offers.
        Each offer returns its title, description, full terms and conditions,
        how to redeem it, artwork and dish photos, original and discounted
        price, discount type and value, remaining stock and sales counters, the
        validity window with the exact weekdays and time slots it can be used on
        plus the dates it is excluded on, and the restaurants it can be redeemed
        at. Filter by offer kind, keyword, restaurant, districts, landmarks,
        cuisines, dishes, restaurant types, category groups and seasonal
        promotions.


        **Price:** 1 credit
      operationId: __api_openrice_coupons_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenriceCouponsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OpenriceCoupon'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    OpenriceCouponsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        region:
          $ref: '#/components/schemas/OpenriceRegion'
          default: hongkong
        lang:
          $ref: '#/components/schemas/OpenriceLang'
          default: en
        coupon_type:
          $ref: '#/components/schemas/OpenriceCouponType'
          default: coupon
        keyword:
          anyOf:
            - type: string
            - type: 'null'
        restaurant:
          anyOf:
            - type: string
            - type: 'null'
        district_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        landmark_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'
        category_group_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        promotion_ids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
        count:
          type: integer
          minimum: 1
      type: object
      required:
        - count
    OpenriceCoupon:
      properties:
        '@type':
          type: string
          default: OpenriceCoupon
        id:
          type: integer
        url:
          anyOf:
            - type: string
            - type: 'null'
        coupon_title:
          type: string
        subtitle:
          anyOf:
            - type: string
            - type: 'null'
        terms:
          anyOf:
            - type: string
            - type: 'null'
        how_to_redeem:
          anyOf:
            - type: string
            - type: 'null'
        coupon_type_id:
          anyOf:
            - type: integer
            - type: 'null'
        offer_id:
          anyOf:
            - type: integer
            - type: 'null'
        booking_menu_id:
          anyOf:
            - type: integer
            - type: 'null'
        offer_type_id:
          anyOf:
            - type: integer
            - type: 'null'
        offer_sub_type_id:
          anyOf:
            - type: integer
            - type: 'null'
        voucher_category_id:
          anyOf:
            - type: integer
            - type: 'null'
        redeem_method_id:
          anyOf:
            - type: integer
            - type: 'null'
        discount_type_id:
          anyOf:
            - type: integer
            - type: 'null'
        discount_value:
          anyOf:
            - type: number
            - type: 'null'
        discount_label:
          anyOf:
            - type: string
            - type: 'null'
        original_price:
          anyOf:
            - type: number
            - type: 'null'
        discount_price:
          anyOf:
            - type: number
            - type: 'null'
        original_price_text:
          anyOf:
            - type: string
            - type: 'null'
        discount_price_text:
          anyOf:
            - type: string
            - type: 'null'
        redemption_limit:
          anyOf:
            - type: integer
            - type: 'null'
        reference_no:
          anyOf:
            - type: string
            - type: 'null'
        quota:
          anyOf:
            - type: integer
            - type: 'null'
        quota_left:
          anyOf:
            - type: integer
            - type: 'null'
        pre_sales_hours:
          anyOf:
            - type: integer
            - type: 'null'
        valid_dates:
          items:
            $ref: '#/components/schemas/OpenriceCouponValidDate'
          type: array
          default: []
        excluded_dates:
          items:
            $ref: '#/components/schemas/OpenriceCouponValidDate'
          type: array
          default: []
        images:
          items:
            type: string
          type: array
          default: []
        image:
          anyOf:
            - type: string
            - type: 'null'
        dish_images:
          items:
            type: string
          type: array
          default: []
        restaurants:
          items:
            $ref: '#/components/schemas/OpenriceCouponRestaurant'
          type: array
          default: []
        restaurant_display_name:
          anyOf:
            - type: string
            - type: 'null'
        district_name:
          anyOf:
            - type: string
            - type: 'null'
        starts_at:
          anyOf:
            - type: integer
            - type: 'null'
        expires_at:
          anyOf:
            - type: integer
            - type: 'null'
        redeem_ends_at:
          anyOf:
            - type: integer
            - type: 'null'
        published_at:
          anyOf:
            - type: integer
            - type: 'null'
        publish_ends_at:
          anyOf:
            - type: integer
            - type: 'null'
        bookmark_count:
          anyOf:
            - type: integer
            - type: 'null'
        sold_count:
          anyOf:
            - type: integer
            - type: 'null'
        sold_count_text:
          anyOf:
            - type: string
            - type: 'null'
        is_quota_enabled:
          type: boolean
          default: false
        is_few_stock:
          type: boolean
          default: false
        is_multi_restaurant:
          type: boolean
          default: false
        is_valid_today:
          type: boolean
          default: false
        is_printable:
          type: boolean
          default: false
        has_alcohol_terms:
          type: boolean
          default: false
      type: object
      required:
        - id
        - coupon_title
    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
    OpenriceCouponType:
      type: string
      enum:
        - coupon
        - voucher
        - merchant_offer
    OpenriceCouponValidDate:
      properties:
        '@type':
          type: string
          default: OpenriceCouponValidDate
        starts_at:
          anyOf:
            - type: integer
            - type: 'null'
        expires_at:
          anyOf:
            - type: integer
            - type: 'null'
        week_days:
          items:
            type: integer
          type: array
          default: []
        times:
          items:
            type: string
          type: array
          default: []
      type: object
    OpenriceCouponRestaurant:
      properties:
        '@type':
          type: string
          default: OpenriceCouponRestaurant
        id:
          type: integer
        url:
          type: string
        name:
          type: string
        district:
          anyOf:
            - $ref: '#/components/schemas/OpenriceDistrict'
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        price_range_id:
          anyOf:
            - type: integer
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
        - url
        - name
    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
    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
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````