Service
한국 당근 마켓플레이스의 공개 매물(중고거래, 부동산, 채용 공고, 중고차)을 지역별로 읽기 전용으로 조회할 수 있습니다.
97.42%30일 가동률평균 응답20ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/daangn-marketplace/cars-detail | Reads one public Daangn cars listing and returns a normalized detail without login or mutation. Use when the caller already has items[].id from daangn-marketplace:cars-search or a public Daangn cars listing URL. At least one of id and canonical_url is required, and when both are provided they must identify the same listing. Do NOT use to find listings — use daangn-marketplace:cars-search instead — and do NOT use for used-goods, realty, or jobs detail — use daangn-marketplace:used-goods-detail, daangn-marketplace:realty-listing-detail, or daangn-marketplace:jobs-detail instead. Detail pages can disappear as listings close, so only the fields available from the submitted listing are returned. Returns item (the normalized listing) and canonical_url. | |
| POST | /v1/daangn-marketplace/cars-search | Searches read-only public Daangn cars listings in one region with an optional keyword. Use when the caller already has a region_id from daangn-marketplace:search-regions; free-text region names are not accepted. Do NOT use for used goods, realty, or jobs — use daangn-marketplace:used-goods-search, daangn-marketplace:realty-search-listings, or daangn-marketplace:jobs-search instead — and do NOT use it to read a single listing — use daangn-marketplace:cars-detail instead. Returns items[] (normalized listing candidates; items[].id is accepted by daangn-marketplace:cars-detail), summary (returned_count, query, region), and canonical_url. | |
| POST | /v1/daangn-marketplace/jobs-detail | Reads one public Daangn jobs listing and returns a normalized detail without login or mutation. Use when the caller already has items[].id from daangn-marketplace:jobs-search or a public Daangn jobs listing URL. At least one of id and canonical_url is required, and when both are provided they must identify the same listing. Do NOT use to find listings — use daangn-marketplace:jobs-search instead — and do NOT use for used-goods, realty, or cars detail — use daangn-marketplace:used-goods-detail, daangn-marketplace:realty-listing-detail, or daangn-marketplace:cars-detail instead. Detail pages can disappear as listings close, so only the fields available from the submitted listing are returned. Returns item (the normalized listing) and canonical_url. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
지난 30일 동안 이 서비스에서 관측된 기록입니다.
| POST | /v1/daangn-marketplace/jobs-search | Searches read-only public Daangn jobs listings in one region with an optional keyword. Use when the caller already has a region_id from daangn-marketplace:search-regions; free-text region names are not accepted. Do NOT use for used goods, realty, or cars — use daangn-marketplace:used-goods-search, daangn-marketplace:realty-search-listings, or daangn-marketplace:cars-search instead — and do NOT use it to read a single listing — use daangn-marketplace:jobs-detail instead. Returns items[] (normalized listing candidates; items[].id is accepted by daangn-marketplace:jobs-detail), summary (returned_count, query, region), and canonical_url. |
| POST | /v1/daangn-marketplace/realty-complex-detail | Reads the public detail of one Daangn realty complex. Use when the caller already has a raw numeric complex id from daangn-marketplace:realty-search-complexes. Do NOT use for the complex's current listings or price history — use daangn-marketplace:realty-complex-listings or daangn-marketplace:realty-complex-price-history instead. Returns complex (name, address, region, building type, household and building counts, approval date, recent transaction and live article counts, area groups, coordinate, buildings, images, assigned schools, nearby preschools, and lived-review count/tag counts/reviews) and canonical_url. |
| POST | /v1/daangn-marketplace/realty-complex-listings | Lists the current article/listing cards attached to one Daangn realty complex. Use when the caller has a raw numeric complex id from daangn-marketplace:realty-search-complexes and needs its current listings; limit caps the number of cards. Do NOT use for complex metadata — use daangn-marketplace:realty-complex-detail instead — or for transaction price history — use daangn-marketplace:realty-complex-price-history instead. Amount fields from article trades are normalized in units of 10,000 KRW (만원) and area fields are exclusive/supply area strings from Daangn. Returns items[] (normalized realty listing candidates), summary (returned_count), and canonical_url. |
| POST | /v1/daangn-marketplace/realty-complex-price-history | Reads the price history of one Daangn realty complex. Use when the caller has a raw numeric complex id from daangn-marketplace:realty-search-complexes and needs the trade chart, optionally narrowed by trade_type or an exclusive-use area group. Do NOT use for current listing cards — use daangn-marketplace:realty-complex-listings instead — or for complex metadata — use daangn-marketplace:realty-complex-detail instead. Returns complex, area_groups[], chart_points[], buy_transactions[], borrow_transactions[], and canonical_url. |
| POST | /v1/daangn-marketplace/realty-listing-detail | Reads one public Daangn realty listing and returns a normalized detail without login or mutation. Use when the caller already has items[].id from daangn-marketplace:realty-search-listings or a public Daangn realty listing URL. At least one of id and canonical_url is required, and when both are provided they must identify the same listing. Do NOT use to find listings — use daangn-marketplace:realty-search-listings instead — and do NOT use for complex detail — use daangn-marketplace:realty-complex-detail instead. Detail pages can disappear as listings close, so only the fields available from the submitted listing are returned. Returns item (the normalized listing) and canonical_url. |
| POST | /v1/daangn-marketplace/realty-search-complexes | Lists Daangn realty (apartment) complexes in one region. Use when the caller has a region_id from daangn-marketplace:search-regions and needs raw numeric complex ids for follow-up calls to daangn-marketplace:realty-complex-detail, daangn-marketplace:realty-complex-listings, or daangn-marketplace:realty-complex-price-history. Do NOT use for individual realty listings — use daangn-marketplace:realty-search-listings instead. Returns items[] (raw numeric complex id as a decimal string, name, building type label, household count, recent transaction count, live article count, and buildings[] with road/jibun addresses when exposed), summary (returned_count, region), and canonical_url. |
| POST | /v1/daangn-marketplace/realty-search-listings | Searches read-only public Daangn realty articles in one region with an optional keyword. Use when the caller already has a region_id from daangn-marketplace:search-regions; free-text region names are not accepted. Do NOT use for apartment complexes — use daangn-marketplace:realty-search-complexes instead — and do NOT use it to read a single listing — use daangn-marketplace:realty-listing-detail instead. When more listings remain, summary.cursor is returned and stays valid for 30 days; pass it unchanged as cursor with the same region_id, query, and limit to fetch the next page. Returns items[] (normalized realty listing candidates with realty:<numeric-id> ids accepted by daangn-marketplace:realty-listing-detail), summary (returned_count, query, region, cursor), and canonical_url. |
| POST | /v1/daangn-marketplace/realty-search-regions | Finds Daangn realty regions from Korean city, district, or dong text and returns matching regions with their child regions. Use when the caller needs the realty region hierarchy (districts or legal dongs); limit remains the maximum number of matches in normal mode, and with legal_dong_only each call expands at most five matching districts into legal-dong children. Do NOT use for used-goods, jobs, or cars region lookup — use daangn-marketplace:search-regions instead. Returns items[], child_regions[], summary (returned_count, query), and canonical_url. |
| POST | /v1/daangn-marketplace/search-regions | Finds Daangn administrative regions that match the query text and returns their raw decimal region ids. Use when you need a region_id before any region-scoped listing or complex search: call this first, then pass items[].id as region_id to daangn-marketplace:used-goods-search, daangn-marketplace:jobs-search, daangn-marketplace:cars-search, daangn-marketplace:realty-search-listings, or daangn-marketplace:realty-search-complexes. Do NOT use for realty region hierarchy or legal-dong expansion — use daangn-marketplace:realty-search-regions instead. Returns items[] (id, name, full_name) and summary (keyword, returned_count). |
| POST | /v1/daangn-marketplace/used-goods-detail | Reads one public Daangn used-goods listing and returns a normalized detail without login or mutation. Use when the caller already has items[].id from daangn-marketplace:used-goods-search or a public Daangn used-goods listing URL. At least one of id and canonical_url is required, and when both are provided they must identify the same listing. Do NOT use to find listings — use daangn-marketplace:used-goods-search instead — and do NOT use for realty, jobs, or cars detail — use daangn-marketplace:realty-listing-detail, daangn-marketplace:jobs-detail, or daangn-marketplace:cars-detail instead. Detail pages can disappear as listings close, so only the fields available from the submitted listing are returned. Returns item (the normalized listing) and canonical_url. |
| POST | /v1/daangn-marketplace/used-goods-search | Searches read-only public Daangn used-goods listings in one region with an optional keyword. Use when the caller already has a region_id from daangn-marketplace:search-regions; free-text region names are not accepted. Do NOT use for realty, jobs, or cars — use daangn-marketplace:realty-search-listings, daangn-marketplace:jobs-search, or daangn-marketplace:cars-search instead — and do NOT use it to read a single listing — use daangn-marketplace:used-goods-detail instead. Returns items[] (normalized listing candidates; items[].id is accepted by daangn-marketplace:used-goods-detail), summary (returned_count, query, region), and canonical_url. |
