ドキュメント
EnCarAPIドキュメント。APIエンドポイントを通じて韓国の自動車データにアクセスする方法をご案内します。統合ガイドとコード例を掲載。
業界経験
韓国市場で長年の経験を持つ自動車データAPIプロバイダー。
週7日サポート
API統合のサポートを週7日体制で提供。
24時間365日稼働
安定したデータ配信のための24時間体制の監視。
リアルタイムリスト通知
新しい車両リストが投稿されると即座にAPIアクセスが可能。
CSV ダウンロード
メーカー、モデル、バッジのリストを CSV でダウンロード - キャッシュしてライブのファセット呼び出しを省けます。
柔軟なエクスポート形式
CSV、JSON、Excel、カスタム形式でデータを取得し、簡単に統合。
ベースURL
すべてのAPIリクエストは以下のベースURLに対して行います：
https://api.encarapi.com例えば、物件を取得する場合：
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true認証
APIキーを使用してリクエストを認証します。クエリパラメータまたはAuthorizationヘッダーで渡してください。
# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"
# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY統合ワークフロー
EnCarAPIとの統合は以下の4つのステップに従ってください。
利用可能なフィルターを取得
すべてのフィルター値を取得（メーカー、モデル、仕様、カラーなど）
GET /filters車両リストを取得
メーカー、モデル、年式、価格などのフィルターを使用してページネーション付きのリストを取得。
GET /offers?page=1変更を追跡
日付に対する変更IDを取得し、追加・変更・削除されたリストをポーリング。
GET /change_id → GET /changesリスト詳細を取得
inner_idを使用して特定のリストの完全な詳細を取得。
GET /offer?inner_id=...APIエンドポイント
韓国車両データにアクセスするためのすべてのエンドポイント。
ドロップダウン用データ（CSV）
メーカー、モデル、バッジのリストを CSV でダウンロードしてキャッシュし、それをもとにドロップダウンを構築できます - クリックごとのファセット呼び出しやオフラインマッピングは不要です。各ファイルには件数の列が含まれ、バッジファイルにはボディスタイルの区分（Coupe／Sedan／Cabrio）が含まれます。
一度ダウンロードしてキャッシュ - 毎日更新
件数付きの全メーカー・モデルの組み合わせ
件数付きの全メーカー・モデル・バッジ値（Coupe／Sedan／Cabrio を含む）
ダウンロードするには API キーを追加します - ファイル URL に ?api_key=YOUR_KEY を付けてください。ファイルはキーで保護されており、有効なキーがなければ誰もダウンロードできません。
データの鮮度
カタログ（価格、走行距離、新規・売却済みの掲載）は約5時間ごとに更新され、1日1回はより詳細な更新が行われます。車両詳細（スペック、写真、状態、事故歴レポート）は独自のより緩やかなサイクルで更新され、通常は変更から3週間以内、カタログが関連する変化を検知した場合はより早く反映されます。
カタログの対象範囲
本カタログは通常販売の掲載のみを対象としています（Encarの販売区分「일반」）。リース譲渡（「리스」）およびレンタル（「렌트」）の掲載は混在させていません - これらは購入価格ではなく月額料金で価格が設定されており、Priceフィールドの数値を歪めてしまうためです。これらの掲載には GET /api/catalog/leasing をご利用ください。
キャッシュ期間の目安
- フィルター値、タクソノミー CSV、/api/nav：24時間キャッシュ
- 車両掲載（/api/catalog）：4〜6時間キャッシュ
- 車両詳細（/api/vehicle/:id）：24時間キャッシュ
これはStarterプランのモデルです。ユーザーがクリックするたびにライブ呼び出しを行うのではなく、自社データベースから掲載情報を配信し、このサイクルで更新してください。このプランには日次のカタログ取得件数上限があり、フルカタログをローカルに保持することではなく、ライブクエリを想定した設計です。
フルコピーが必要な場合は？
BusinessおよびScaleプランには、GET /api/catalog/export（日次上限にカウントされない、CSV形式の1日1回のフルスナップショット）と GET /api/catalog/changes?since=...（前回の同期以降に追加・更新・再掲載・削除された掲載）が含まれます。エクスポートで一度データベースを初期化し、その後はchangesをポーリングして最新の状態を保つことで、カタログ全体の再取得が不要になります。Scaleプランでは、カタログ取得件数の日次上限が完全に撤廃されます。
重複掲載
韓国の販売店は、露出を増やすために同じ車両を異なる掲載IDで二重に掲載することがよくあります - 価格、走行距離、年式、モデル/グレードが同一です。当社はこれを検出し、追加のコピーに IsDuplicate: true と DuplicateOf: <元の掲載ID> を付与します。元の掲載にはフラグは付きません。重複はフラグが付くだけで削除はされないため、どう扱うかはお客様次第です - /api/catalog または /api/catalog/leasing に exclude_duplicates=true を指定すると、サーバー側で除外できます。
よくある質問
始める準備はできましたか？
Telegramでお問い合わせいただき、API認証情報を取得して、今すぐ韓国自動車データへのアクセスを開始しましょう。