터키 중고차 시장을 위한 3개의 API를 Apify로 구축했습니다

Source: Dev.to

죄송합니다만, 외부 URL에 직접 접근하여 해당 페이지의 내용을 가져올 수 없습니다. 번역이 필요한 텍스트를 여기 채팅에 복사해 주시면, 요청하신 대로 한국어로 번역해 드리겠습니다.

Source: …

터키 중고차 시장 – API 스위트

터키의 중고차 시장은 규모가 크고 파편화되어 있으며, 구조화된 데이터를 원한다면 생각보다 다루기 어렵습니다.

• 리스트가 여러 마켓플레이스에 흩어져 있습니다.
• 딜러 페이지가 일관되지 않습니다.
• 가격이 빠르게 변동합니다.
• “이 차는 얼마 정도 가치가 있나요?” 혹은 “이 브랜드에서 이스탄불을 장악하고 있는 딜러는 어디인가요?” 같은 간단한 질문조차 예상보다 어렵습니다.

솔루션

문제의 다양한 층을 해결하기 위해 Apify 위에 세 개의 특화된 API를 구축했습니다.

세 API 모두 깨지기 쉬운 스크래핑 스크립트 대신 깨끗한 터키 차량 데이터가 필요한 개발자를 위해 설계되었습니다.

1. Arabam.com Vehicle Scraper API

목적: 원시 데이터 레이어 – Arabam.com에서 구조화된 중고차 리스트를 추출합니다.

반환 필드 (예시):

{
  "listingId": "38718353",
  "title": "Galeriden Volkswagen Passat 1.6 TDi BlueMotion Business 2020 Model Mersin 124.000 km Füme",
  "make": "Volkswagen",
  "model": "Passat",
  "year": 2020,
  "price": {
    "amount": 2025000,
    "currency": "TRY"
  },
  "mileage": 124000,
  "fuelType": "dizel",
  "transmission": "yarı_otomatik",
  "city": "Yüksek Mh. Erdemli, Mersin",
  "sellerType": "galeri",
  "url": "https://www.arabam.com/ilan/..."
}

일반적인 사용 사례

• 자체 차량 마켓플레이스 데이터셋 구축.
• 특정 메이크/모델에 대한 리스트 공급량 모니터링.
• 다운스트림 분석을 위한 비교 판매 데이터 수집.
• 머신러닝 또는 BI 파이프라인에 데이터 공급.

요청 예시

{
  "searchUrls": [
    "https://www.arabam.com/ikinci-el/otomobil/volkswagen-passat"
  ],
  "maxListings": 5,
  "scrapeDetails": true
}

리스트 수준의 데이터가 필요하다면, 이 API가 시작점입니다.

2. Turkish Auto Price Tracker API

목적: 의사결정 레이어 – 원시 리스트를 평가 신호로 변환합니다.

API는 제공한 차량 사양을 기반으로 Arabam과 Sahibinden을 검색하고 다음을 반환합니다.

• 리스트 수준 가격 기록.
• 중앙값, 평균, 최소, 최대 및 백분위 가격.
• 판매자 유형별 분류.
• 주행거리 구간 분석.

요청 예시

{
  "vehicles": [
    {
      "make": "Volkswagen",
      "model": "Passat",
      "yearMin": 2018,
      "yearMax": 2022,
      "fuelType": "dizel"
    }
  ],
  "platforms": ["arabam"],
  "maxListingsPerPlatform": 10
}

응답 예시 (요약 레코드)

{
  "type": "PRICE_SUMMARY",
  "totalListingsUsed": 10,
  "overall": {
    "averagePrice": 1839438,
    "medianPrice": 1795750,
    "minPrice": 1525000,
    "maxPrice": 2169000
  }
}

이 API가 답변할 수 있는 전형적인 질문

• 2020년식 디젤 Passat의 현재 가치는 얼마인가요?
• 이 제시 가격이 시장보다 높은가요?
• 딜러 가격은 개인 판매자 가격과 어떻게 비교되나요?

원시 마켓플레이스 잡음을 활용 가능한 시장 신호로 변환하기 때문에, 이 세트 중 가장 비즈니스 친화적인 API입니다.

3. Turkish Auto Dealer Intelligence API

목적: 시장 구조 레이어 – 개별 차량이 아닌 딜러에 초점을 맞춥니다.

특정 딜러 URL을 스크래핑하거나 도시별 딜러를 탐색한 뒤, 구조화된 딜러 프로필과 선택적인 재고 분석을 반환합니다.

요청 예시

{
  "platforms": ["arabam"],
  "searchByCity": "istanbul",
  "maxDealers": 3,
  "includeInventory": false
}

재고 미포함 딜러 프로필 예시

{
  "type": "DEALER_PROFILE",
  "dealerName": "CM MOTORS",
  "city": "İstanbul",
  "district": "Fatih Oto Galeri",
  "phone": "(0539) 812 32 20",
  ...
}

Source: https://github.com/your-repo/automotive-apis

{
  "dealerUrl": "https://www.arabam.com/galeri/cm-motors-istanbul"
}

예시 딜러 프로필 (재고 포함)

{
  "inventory": {
    "totalListings": 6,
    "averagePrice": 573483,
    "medianPrice": 654000,
    "priceRange": {
      "min": 259000,
      "max": 789000
    }
  }
}

일반적인 사용 사례

• 딜러 벤치마킹
• 리드 생성
• 도시별 시장 매핑
• 재고‑전략 분석
• B2B 자동차 인텔리전스

왜 세 개의 API로 나누나요?

이 모든 것을 하나의 거대한 “자동차 스크래퍼”에 강제로 넣으면 제품이 이해하기 어렵고, 가격 책정 및 통합이 복잡해집니다. 보다 좁은 범위의 세 API가 가치 제안을 훨씬 명확하게 합니다.

오픈‑소스 및 기여

이 API들은 오픈 소스이며, 저장소를 확인하세요: .

기여를 환영합니다. 다음과 같은 방법으로 도울 수 있습니다:

• 마켓플레이스 커버리지 확대
• 파서 강화
• 새로운 출력 필드 추가
• 딜러 분석 개선
• 더 많은 터키 자동차 워크플로 지원

함께 실용적인 오픈‑데이터 도구를 만들어 봅시다!

터키 자동차 생태계를 위한 실용적인 데이터 레이어

단순히 폐쇄된 제품이 아닙니다.

최종 생각

터키 자동차 시장에는 공개된 데이터가 많지만, 깨끗하고 재사용 가능한 인터페이스는 부족합니다.

이 API들이 메우고자 하는 바로 그 격차입니다.

• 리스트‑레벨 데이터 – Vehicle Scraper 사용
• 평가 데이터 – Price Tracker 사용
• 딜러‑레벨 시장 인텔리전스 – Dealer Intelligence API 사용

이 스택을 통해 스크래핑 및 정규화 작업을 처음부터 다시 구축하지 않고도 터키 중고차 시장을 위한 실용적인 데이터 레이어를 확보할 수 있습니다.