ドキュメント

ベース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

5日間トライアル

3つのマーケットプレイスすべて（Encar、KB Chachacha、K Car）を対象に、変更フィード（直近7日間）、一括取得（1日あたり1,000件のid）、アーカイブのプレビュー（1日あたり削除済み掲載100件）を含め、APIを5日間お試しいただけます。カタログ合計100,000行、詳細取得は合計2,000件（1日最大1,000件）。参照データのダウンロード（CSV）は有料プランに含まれます。フルカタログエクスポートは Business プランからご利用いただけます。トライアル終了後、サブスクリプションは Starter プラン（月額 €149）で自動継続します - 5日目までにいつでもキャンセル可能です。

ロシア語の値 (lang=ru)

lang=en を受け付けるすべてのエンドポイントは lang=ru も受け付けます。表示用の値がロシア語で返り、それ以外 (ID、コード、価格、数値、フィールド名) は変わりません。ロシア語ラベルがない値は英語になります。ロシア語ラベルは今後改善されることがあるため、データはラベルではなく ID とコードで紐付けてください。

• 翻訳対象: 燃料、トランスミッション、駆動方式、外装色と内装色、ボディクラス、販売形態、地域名と都市名、オプション名、グレード名に含まれる一般的な語 (Diesel -> дизель, 7-Seater -> 7 мест)。モデル世代: Carnival 4 Gen -> Carnival 4 поколение。ブランド名、モデル名、グレード名はロシアの中古車サイトと同様にラテン文字のままです。
• フィルターはロシア語の値も受け付けます: fuel=дизель, color=белый, region=Сеул, city=Сувон, drivetrain=полный, sell_type=лизинг。英語の値も引き続き使えます。
• /api/enums?lang=ru はすべての値に nameRu を追加し、drivetrain と sell_type の値も一覧にします。/api/nav?lang=ru はロシア語の DisplayValue を返し、Value はフィルター用の英語コードのままです。リファレンス CSV に lang=ru を付けると、最後の列の後にロシア語名の列が追加されます。
• /api/vehicle/{id}?lang=ru と bulk エンドポイントは、Encar の spec の値、category 名、optionsDecoded 名をロシア語で返し、KB Chachacha の掲載はカタログと同じ形で返します。
• /api/catalog/export?lang=ru はラベル列がロシア語になった同じファイルです。列の順序とその他の列は変わりません。
• 翻訳されないもの: 検査レポート、保険履歴、Encar 診断、Encar 車両履歴、K Car の詳細データ、Encar のオプションパッケージ (掲載の自由記述)、トラックと掘削機のエンドポイント (lang=ru でも英語で返ります)。

# Russian values, filtered with Russian values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?fuel=дизель&city=Сувон&lang=ru&count=true"

# Filter values with their Russian labels (nameRu)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/enums?lang=ru"

ドイツ語の値 (lang=de)

lang=de は lang=ru と同じように動作します。表示用の値がドイツ語で返り、それ以外 (ID、コード、価格、数値、フィールド名) は変わりません。ドイツ語ラベルがない値は英語になります。

• 翻訳対象: 燃料、トランスミッション、駆動方式、色、ボディクラス、販売形態、オプション名、そしてドイツ語テーブルにあるモデル名とグレード名 (C-Class -> C-Klasse, 5-Series -> 5er, Carnival 4 Gen -> Carnival 4. Generation, 7-Seater -> 7-Sitzer, Sedan -> Limousine)。地域名は英語名、都市名は英語のままです。
• フィルターはドイツ語の値も受け付けます: fuel=Benzin, color=Weiß, transmission=Automatik, drivetrain=Allrad, sell_type=Leasingübernahme, model_group=C-Klasse。ドイツ語のモデル名はマイナーチェンジ前後をまとめることがあります: Carnival 4. Generation は Carnival 4 Gen と The New Carnival 4 Gen の両方を含みます。
• 一覧、詳細、bulk、エクスポートは lang=ru と同じです: /api/enums と /api/taxonomy/option-packages に nameDe、/api/nav にドイツ語の DisplayValue、リファレンス CSV に *_de 列、エクスポートは catalog_export_de.csv。翻訳されないものも lang=ru と同じです。

# German values, filtered with German values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=Mercedes-Benz&model_group=C-Klasse&fuel=Benzin&lang=de&count=true"

3つのマーケットプレイス、1つのAPI

このAPIは、韓国の3大中古車マーケットプレイスの最新の掲載情報を提供します。すべてのエンドポイントはデフォルトで Encar を返すため、既存の連携は変更なしでそのまま動作します。残りの2つは source パラメータで任意に有効化できます。

ソースの選択

source は /api/catalog、/api/nav、/api/enums、/api/model-search、/api/catalog/export、/api/catalog/changes、およびタクソノミーCSVで指定できます。

# All three marketplaces, English values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=all&manufacturer=bmw&fuel=diesel&lang=en&count=true"

# K Car only
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=kcar&manufacturer=hyundai&lang=en"

# One KB Chachacha vehicle
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/vehicle/kbc:12345678?lang=en"

source を指定すると、各アイテムに Source フィールドが付きます。Encar のIDは数値のままです。KB Chachacha と K Car のIDにはプレフィックス (kbc:..., kcar:...) が付きます - そのまま /api/vehicle/{id} に渡してください。lang=en を指定すると、3つのマーケットプレイスすべてのモデル名とトリム名が英語で返されます。

ディーラーは同じ車両を Encar と KB Chachacha の両方に掲載することがよくあります。KB Chachacha の掲載は韓国のナンバープレートで、KB Chachacha がナンバーを公開していない場合は初度登録年月・走行距離・価格で、有効な Encar の掲載と照合されます。照合は Encar と KB Chachacha のカタログ巡回のたびに、1日に数回再計算されます。照合された KB Chachacha の掲載は、source の有無にかかわらず（source=kbc のみの場合も）、/api/catalog、/api/catalog/export、その他のカタログエンドポイントでは返されないため、同じ車両が2回表示されることはありません。Encar を含む場合は Encar の掲載として返されます。

/api/catalog/changes?source=kbc と /api/vehicle/kbc:{id} では、これらの掲載に IsDuplicate: true と DuplicateOf（Encar の掲載ID、数字文字列）が付きます。Encar のアイテムと同様、どちらのフィールドも true の場合にのみ含まれます。フラグが付く、または外れると、変更フィードは changedFields に duplicate を含む updated イベントを記録します。ローカルコピーを /api/catalog と一致させるには、IsDuplicate: true 付きで届いた KB Chachacha のアイテムを削除し、このフィールドのない更新が届いたら再び追加してください。

変更フィードは1回の呼び出しにつき1つのソース (encar、kbc、kcar のいずれか) を受け付け、ソースごとに個別のカーソルを保持します。

マーケットプレイス別の対応範囲

すべてのマーケットプレイスがすべてのフィールドを公開しているわけではありません。

• KB Chachacha は一部の掲載で座席数を公開しています。
• KB Chachacha の詳細 = カタログアイテムに公開履歴ブロック (事故フラグ、全損、冠水、営業用使用、担保権、フレームおよびパネルの診断) を加えたものです。 すべての KB Chachacha アイテムには InsuranceClaims (掲載ページに表示される保険事故の件数) も含まれます。詳細には InspectionReportUrl と InspectionReportType も含まれます。KB Chachacha がその車に掲載している点検記録簿です（link = 点検業者のサイト上の記録簿、scan = 掲載ページ上のスキャン画像のみ、null = まだ不明）。InspectionAvailable が true の場合、GET /api/inspection/kbc:{id} はこの記録簿を Encar の点検レポートと同じ形式の構造化データ (master、outers、inners、images) として返し、あわせて source ブロックも返します。対象は、点検記録簿のある KB Chachacha の掲載の約5件に2件です。
• K Car には個別のレポート文書がありません。事故件数、保険金支払い、所有者変更は車両詳細に含まれます。

マーケットプレイスが提供していないフィールドで絞り込むと、そのマーケットプレイスの車両は結果から除外されます。例: frame_clean=true と source=all の組み合わせでは、Encar と K Car の掲載のみが返されます。

APIエンドポイント

韓国車両データにアクセスするためのすべてのエンドポイント。

ドロップダウン用データ（CSV）

メーカー、モデル、バッジのリストを CSV でダウンロードしてキャッシュし、それをもとにドロップダウンを構築できます - クリックごとのファセット呼び出しやオフラインマッピングは不要です。各ファイルには件数の列が含まれ、バッジファイルにはボディスタイルの区分（Coupe／Sedan／Cabrio）が含まれます。

よくある質問