NOL (Yanolja) rooms API reference

KRW only. total is the stay for one room as it goes into the cart, before coupons and points; list_total is before NOL's own discount and price the nightly average. Plans that cannot be booked (sold out, too many guests for the room) come back with bookable: false, NOL's reason and no price. A stay NOL marks sold out answers availability: sold_out; dates it does not sell, stays longer than the property allows and parties no room takes are a 422.

Request

POSThttps://api.scrapercompany.com/v1/ota/yanolja

Authenticate with your API key in the x-api-key header (see Authentication).

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Body

JSON object. Unknown fields are rejected with 422.

staystringrequiredmin length 1, max length 300
NOL stay id, or its page URL (nol.yanolja.com/stay/domestic/3000998).
check_instring (date)required
First night of the stay, YYYY-MM-DD.
check_outstring (date) | null
Departure date. An alternative to nights — if both are given, this wins.
nightsintegerdefault 1min 1, max 30
Length of stay. Ignored when check_out is supplied.
adultsintegerdefault 2min 1, max 20
Adults in the one room quoted.

Example request

curl -X POST "https://api.scrapercompany.com/v1/ota/yanolja" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stay": "3000998",
    "check_in": "2026-12-25"
  }'

Response

200 — NOL (Yanolja) rooms and rate plans (KRW, before coupons). Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response

{
  "search_parameters": {
    "engine": "yanolja_property",
    "stay_id": "3000998",
    "check_in_date": "2027-03-08",
    "check_out_date": "2027-03-10",
    "nights": 2,
    "adults": 2
  },
  "property": {
    "property_id": "3000998",
    "name": "송도 센트럴파크 호텔",
    "category": "HOTEL",
    "url": "https://nol.yanolja.com/stay/domestic/3000998",
    "price_per_night": 140000,
    "total": 280000,
    "currency": "KRW",
    "sold_out": false,
    "availability": "available",
    "is_soldout": false,
    "provenance": {
      "schema_version": 1,
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "source": "yanolja",
      "source_kind": "ota_rate_plan",
      "source_property_id": "3000998",
      "requested_currency": "KRW",
      "returned_currency": "KRW",
      "price_basis": "stay_total_before_coupons",
      "derivation": "normalized_upstream",
      "upstream_rate_id": "590981"
    },
    "rooms": [
      {
        "name": "펫캉스 디럭스 패밀리트윈",
        "room_code": "484186",
        "standard_capacity": 2,
        "max_capacity": 3,
        "available": true,
        "cheapest_price": 140000,
        "rate_plans": [
          {
            "plan_id": "590981",
            "room_code": "484186",
            "name": "펫캉스 디럭스 패밀리트윈",
            "use_type": "overnight",
            "price": 140000,
            "total": 280000,
            "list_total": 320000,
            "currency": "KRW",
            "bookable": true,
            "cancel_policy": "무료취소 (11.28 (토) 17:00전까지)",
            "member_only": false,
            "provenance": {
              "schema_version": 1,
              "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
              "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
              "observed_at": "2026-08-07T01:23:45.678Z",
              "source": "yanolja",
              "source_kind": "ota_rate_plan",
              "source_property_id": "3000998",
              "requested_currency": "KRW",
              "returned_currency": "KRW",
              "price_basis": "stay_total_before_coupons",
              "derivation": "normalized_upstream",
              "upstream_rate_id": "590981"
            },
            "rate_code": "590981",
            "rate_category": "unknown",
            "refundable": true,
            "rate_code_scope": "room"
          }
        ]
      }
    ]
  },
  "meta": {
    "source": "yanolja",
    "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
    "observed_at": "2026-08-07T01:23:45.678Z",
    "nights": 2,
    "adults": 2,
    "elapsed_s": 1.09,
    "total_rate_plans": 19,
    "notes": "KRW only. `total` is the stay for one room as it goes into the cart, before coupons and points; `list_total` is before NOL's own discount. Plans that cannot be booked have `bookable: false`, NOL's reason and no price."
  }
}

Response fields

Fields marked required are always present; others appear when they apply.

search_parametersobjectrequired
Show 6 child fieldsHide child fields
- search_parameters.enginestringrequired
  One ofyanolja_property
- search_parameters.stay_idstringrequired
- search_parameters.check_in_datestring (date)required
- search_parameters.check_out_datestring (date)required
- search_parameters.nightsintegerrequired
- search_parameters.adultsintegerrequired
propertyobjectrequired
Show 14 child fieldsHide child fields
- property.property_idstringrequired
  The NOL stay id.
- property.namestring | nullrequired
- property.categorystring | nullrequired
  e.g. HOTEL, PENSION.
- property.urlstringrequired
- property.price_per_nightnumber | nullrequired
  Cheapest bookable overnight plan's nightly average.
- property.totalinteger | nullrequired
  That plan's total.
- property.currencystringrequired
  One ofKRW
- property.sold_outbooleanrequired
- property.availabilitystringrequired
  One ofavailablesold_out
- property.is_soldoutboolean | nullrequired
- property.availability_reasonstring | nullrequired
- property.min_length_of_stayinteger | nullrequired
- property.provenanceobject | nullrequired
  Provenance of the cheapest priced row; null when nothing priced.
  Show 13 child fieldsHide child fields
  - property.provenance.schema_versionintegerrequired
    Provenance schema version (currently 1).
  - property.provenance.observation_idstringrequired
    Deterministic id of this price observation (rateobs_...).
  - property.provenance.collection_idstringrequired
    Id shared by every price from one upstream fetch (ratecol_...).
  - property.provenance.observed_atstringrequired
    UTC observation time, ISO-8601.
  - property.provenance.sourcestringrequired
    Upstream source, e.g. google_hotels_calendar.
  - property.provenance.source_kindstringrequired
    Kind of source, e.g. calendar, offer, ota_calendar, official.
  - property.provenance.source_property_idstringrequired
    Property identifier at the source.
  - property.provenance.requested_marketstring | nullrequired
  - property.provenance.requested_currencystring | nullrequired
  - property.provenance.returned_currencystring | nullrequired
  - property.provenance.price_basisstringrequired
    What the price represents, e.g. room_base_before_taxes_and_fees.
  - property.provenance.derivationstringrequired
    How the figure was derived, e.g. normalized_upstream.
  - property.provenance.upstream_rate_idstring | nullrequired
    Source-native rate/room id when available.
- property.roomsarray of objectrequired
  Show 7 child fieldsHide child fields
  - property.rooms[].namestringrequired
  - property.rooms[].room_codestringrequired
  - property.rooms[].standard_capacityinteger | nullrequired
  - property.rooms[].max_capacityinteger | nullrequired
  - property.rooms[].availablebooleanrequired
  - property.rooms[].cheapest_pricenumber | nullrequired
  - property.rooms[].rate_plansarray of objectrequired
metaobjectrequired
Show 8 child fieldsHide child fields
- meta.sourcestringrequired
  One ofyanolja
- meta.collection_idstringrequired
- meta.observed_atstringrequired
- meta.nightsintegerrequired
- meta.adultsintegerrequired
- meta.elapsed_snumberrequired
- meta.total_rate_plansintegerrequired
- meta.notesstringrequired

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

Status	Meaning	Retry?
`401`Unauthorized	Missing or invalid API key. `{"detail":"missing or invalid API key"}`	No, fix the request
`402`Payment Required	Not enough credits for this request: the account's credits mode is `enforce` (`mode` in `GET /v1/billing`) and the request costs more than the available credits. Nothing is run or charged. `{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}`	No, fix the request
`404`Not Found	The property, stay, job or record was not found. `{"detail":"job not found"}`	No, fix the request
`422`Unprocessable Content	Request validation failed. `detail` is a list of problems for schema errors, or a string for semantic checks performed by the endpoint. `{"detail":[{"loc":["body","name"],"msg":"Field required","type":"missing"}]}`	No, fix the request
`429`Too Many Requests	Too many requests: the key's requests-per-minute limit was exceeded, or (in `enforce` credits mode) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry. `{"detail":"rate limit 60/min exceeded"}`	Yes, with backoff
`503`Service Unavailable	Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later. `{"detail":"database unavailable: OperationalError"}`	Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
Copy the cURL example above and run it in a terminal.

Credits

12 credits per successful call. Failed, blocked and empty results are free.

Request#

Body#

Example request#

Response#

Response fields#

Errors#

Try it#