POST /api/daangn/realty/complexes
Price: 5 credits
Get a Daangn (당근) apartment or officetel complex by id: households, buildings, floors, parking, heating, floor plans by area, nearby subway stations and assigned schools, KB price estimates, monthly average prices, recorded deals, live listings, brokers and resident reviews
Complex ids come from daangn/realty/complexes/search. Prices are in KRW. daangn/realty/complexes/reviews returns every resident review.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)complex string required — Daangn apartment or officetel complex id (examples: "11116956"; minLength: 1)@type string (default: "DaangnComplex")id string requirednode_id string nullableurl string requiredname string nullableproperty_type string nullableapproval_date integer nullablelatitude number nullablelongitude number nullableregion object nullable@type string (default: "DaangnComplexRegion")id string nullablecity string nullabledistrict string nullableneighborhood string nullableroad_address string nullablejibun_address string nullablepostal_code string nullablebuilding_addresses array (default: [])household_count integer nullablebuilding_count integer nullablemin_floor integer nullablemax_floor integer nullableparking_count integer nullableparking_per_household number nullableparking_grade integer nullablehas_parking_variance boolean nullableheating_method string nullableheating_fuel string nullableconstructor string nullablefloor_area_ratio number nullablebuilding_coverage_ratio number nullableev_chargers_underground integer nullableev_chargers_outdoor integer nullablemaintenance_cost_per_m2 object (default: {})* numberis_near_station boolean nullableis_next_to_elementary_school boolean nullableresident_survey object (default: {})* arrayarea_groups array (default: [])@type string (default: "DaangnComplexAreaGroup")exclusive_area_m2 number nullablehousehold_count integer nullableis_representative boolean nullablefloor_plans array (default: [])@type string (default: "DaangnComplexFloorPlan")plan_type string nullabletype_code string nullableexclusive_area_m2 number nullablesupply_area_m2 number nullablehousehold_count integer nullableroom_count integer nullablebathroom_count integer nullablefloor_plan_image string nullableextended_floor_plan_image string nullablesubway_stations array (default: [])@type string (default: "DaangnComplexStation")name string nullableline string nullablewalking_minutes number nullabledistance_m number nullablelatitude number nullablelongitude number nullableelementary_schools array (default: [])@type string (default: "DaangnComplexSchool")id string nullablename string nullablewalking_minutes number nullablewalking_distance_m number nullabledistance_m number nullableallocation_method string nullableassigned_buildings array (default: [])is_assigned_to_all_buildings boolean nullablereview_count integer nullablemiddle_schools array (default: [])@type string (default: "DaangnComplexSchool")id string nullablename string nullablewalking_minutes number nullablewalking_distance_m number nullabledistance_m number nullableallocation_method string nullableassigned_buildings array (default: [])is_assigned_to_all_buildings boolean nullablereview_count integer nullablehigh_schools array (default: [])@type string (default: "DaangnComplexSchool")id string nullablename string nullablewalking_minutes number nullablewalking_distance_m number nullabledistance_m number nullableallocation_method string nullableassigned_buildings array (default: [])is_assigned_to_all_buildings boolean nullablereview_count integer nullablepreschools array (default: [])@type string (default: "DaangnComplexPreschool")id string nullablename string nullablelatitude number nullablelongitude number nullableimages array (default: [])listing_count integer nullablelistings array (default: [])@type string (default: "DaangnRealtyCard")id string requirednode_id string nullableproperty_type string nullablestatus string nullableheadline string nullablebuilding_name string nullablearea_m2 number nullablesupply_area_m2 number nullablefloor string nullabletop_floor string nullablefloor_band string nullableis_entire_building boolean nullablecomplex_name string nullablecomplex_type string nullableverification object nullable@type string (default: "DaangnVerification")lessor string nullablelessor_is_corporation boolean nullabletenant string nullablecorporation string nullablecorporation_role string nullableresident string nullableis_writer_resident boolean nullabletrades array (default: [])@type string (default: "DaangnRealtyTrade")trade_type string nullabledeposit number nullablemonthly_rent number nullableprice number nullableis_preferred boolean nullabledescription string nullableimages array (default: [])video_thumbnail string nullablelatitude number nullablelongitude number nullableneighborhood string nullabledistrict string nullablesubway_stations array (default: [])@type string (default: "DaangnSubwayStation")name string nullablelines array (default: [])walk_minutes integer nullablewriter_type string nullablewriter_sub_type string nullablewriter_id string nullablewriter_name string nullablebroker_badges array (default: [])watch_count integer nullablebrokers array (default: [])@type string (default: "DaangnBroker")id string nullablename string nullablecompany_name string nullablebusiness_registration_number string nullablelicense_number string nullablerepresentative string nullablephone string nullableroad_address string nullablejibun_address string nullableimage string nullablestatus string nullableis_verified boolean nullablelisting_counts object (default: {})* integerkb_sale_price_low number nullablekb_sale_price_high number nullablekb_survey_date integer nullablekb_prices array (default: [])@type string (default: "DaangnComplexKbPrice")trade_type string nullablesurvey_date integer nullableprice number nullableprice_history array (default: [])@type string (default: "DaangnComplexPricePoint")trade_type string nullablemonth integer nullableaverage_price number nullabletransaction_count integer nullabledeals array (default: [])@type string (default: "DaangnComplexDeal")trade_type string nullabledeal_date integer nullableprice number nullableexclusive_area_m2 number nullablerecent_transactions array (default: [])@type string (default: "DaangnComplexTransaction")id string nullabletrade_type string nullabledeal_date integer nullableprice number nullabledeposit number nullablemonthly_rent number nullableexclusive_area_m2 number nullablefloor string nullablecontract_type string nullableis_renewal boolean nullableis_canceled boolean nullableownership string nullableregistered_at integer nullablereported_at integer nullablereview_count integer nullablereview_tag_counts object (default: {})* integerreview_summary string nullablereviews array (default: [])@type string (default: "DaangnComplexReview")id string nullabletext string nullablerating string nullablepros array (default: [])pros_text string nullablecons array (default: [])cons_text string nullabletags array (default: [])lived_period string nullablehelpful_count integer nullableimages array (default: [])author_name string nullableauthor_image string nullableauthor_checkins object (default: {})* integerneighborhood string nullablecreated_at integer nullable422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — Daangn has no complex under that id Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.