आपको वित्तपोषण प्रवाह के लिए ऐसे वाहन मूल्यांकन की आवश्यकता है जिन पर आप भरोसा कर सकें: LTV की गणना करें, संपार्श्विक की कीमत, पूर्व-भरे प्रस्ताव, और अंडरराइटिंग से पहले आउटलेयर को चिह्नित करें। इस गाइड के अंत तक, आप एकल VIN के साथ Zyla API Hub पर अनुमानित वाहन बाजार मूल्य API को कॉल करेंगे, आवश्यक आंकड़ों (औसत, वितरण, माइलेज समायोजन) को पार्स करेंगे, और उन्हें अपने PHP बैकएंड में प्लग करेंगे—इसके अलावा यह देखेंगे कि निर्माताओं और मॉडलों को कैसे क्वेरी करें और MCP के माध्यम से AI एजेंट से उसी API को कैसे लागू करें।
यह API क्या करती है और यह वित्त के लिए क्यों महत्वपूर्ण है
अनुमानित वाहन बाजार मूल्य API एक VIN द्वारा पहचाने गए वाहन के लिए बाजार मूल्य के अनुमान लौटाती है, जिसमें औसत मूल्य, मानक विचलन, तुलनीय लिस्टिंग की संख्या, एक मूल्य वितरण, और माइलेज-आधारित समायोजन शामिल हैं। यह ठीक वही डेटा है जिसकी आपको वित्त कार्यप्रवाह को शक्ति देने के लिए आवश्यकता है जैसे:
- ऋण उत्पत्ति और स्वचालित पूर्व-स्वीकृतियों में LTV गणनाएँ।
- संपार्श्विक निगरानी और पोर्टफोलियो जोखिम स्कोरिंग।
- प्रस्ताव प्रबंधन (जैसे, बायआउट कोट, ट्रेड-इन) वितरण बैंड के आधार पर गार्डरेलों के साथ।
- बाजार के औसत और मानक विचलन के खिलाफ अनुरोधित राशियों की तुलना करके धोखाधड़ी/आउटलेयर का पता लगाना।
API उन अंत बिंदुओं को भी उजागर करती है जो समर्थित निर्माताओं और उनके मॉडलों को खोजने में मदद करती है, जो तब मान्यता में मदद करती है जब आपके पास केवल आंशिक रिकॉर्ड होता है।
Zyla API Hub पर शुरू करना
Zyla API Hub एक मार्केटप्लेस है जिसमें 10,000 से अधिक सार्वजनिक APIs और लिस्टिंग के बीच एकल सदस्यता + कोटा मॉडल है, इसलिए आप हर जगह एक ही खाता और एक ही API कुंजी का उपयोग करते हैं। एक्सेस प्राप्त करने के लिए:
- अनुमानित वाहन बाजार मूल्य API पृष्ठ खोलें।
- सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें)। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। हब एक सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। कोई मुफ्त योजना नहीं।
- अपनी API कुंजी कॉपी करें और Authorization: Bearer YOUR_API_KEY के साथ अंत बिंदुओं को कॉल करें।
यदि आपके पास अभी तक खाता नहीं है, तो यहां एक बनाएं: पंजीकरण करें। आप मार्केटप्लेस में एक ही क्रेडेंशियल का उपयोग करेंगे और अपने डैशबोर्ड से अपने कोटा का प्रबंधन कर सकते हैं।
आप वास्तव में उपयोग करेंगे ऐसा अंत बिंदु संदर्भ
नीचे सभी अंत बिंदुओं को आपकी कुंजी के साथ Authorization हेडर की आवश्यकता होती है और ये Zyla API Hub द्वारा प्रदान किए गए मानक HTTPS GET हैं। दिखाए गए सटीक URLs और पैरामीटर का उपयोग करें।
1) वाहन मूल्य डेटा प्राप्त करें
विधि: GET
URL: https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data
विवरण: एक VIN प्रदान करें और अनुमानित बाजार मूल्य आंकड़े और वितरण प्राप्त करें।
आवश्यक क्वेरी पैरामीटर:
- vin (string): वाहन VIN। उदाहरण: 3FMTK3SU3NMA08229
आधिकारिक कर्ल:
curl -s -X GET "https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data?vin=3FMTK3SU3NMA08229"
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक JSON नमूना प्रतिक्रिया:
{
"status": true,
"code": 200,
"data": {
"vin": "4T1DAACK7SU510354",
"success": true,
"id": "2025_toyota_camry_",
"vehicle": "2025 Toyota Camry ",
"mean": 34959.82,
"stdev": 3109,
"count": 26,
"mileage": 10166,
"certainty": 95,
"period": [
"2024-05-16",
"2024-07-26"
],
"prices": {
"average": 34959.82,
"below": 31849.83,
"above": 38069.81,
"distribution": [
{
"group": {
"min": 30867,
"max": 31428,
"count": 3
}
},
{
"group": {
"min": 31428,
"max": 32494,
"count": 3
}
},
{
"group": {
"min": 32494,
"max": 32603,
"count": 2
}
},
{
"group": {
"min": 32603,
"max": 32988,
"count": 3
}
},
{
"group": {
"min": 32988,
"max": 34189,
"count": 3
}
},
{
"group": {
"min": 34189,
"max": 34497,
"count": 2
}
},
{
"group": {
"min": 34497,
"max": 36988,
"count": 3
}
},
{
"group": {
"min": 36988,
"max": 38216,
"count": 2
}
},
{
"group": {
"min": 38216,
"max": 39842,
"count": 3
}
},
{
"group": {
"min": 39842,
"max": 41392,
"count": 2
}
}
]
},
"adjustments": {
"mileage": {
"average": 12015.69,
"input": 10166,
"adjustment": 80
}
}
},
"message": "Data Fetched Successfully!"
}वित्त प्रवाह में उपयोग करने के लिए:
- data.prices.average: संपार्श्विक मूल्य और LTV के लिए आधार रेखा।
- data.stdev और data.prices.distribution: जोखिम बफर और आउटलेयर थ्रेशोल्ड सेट करें।
- data.count: विश्वास का प्रॉक्सी (अनुमान के पीछे कितनी तुलनीय लिस्टिंग हैं)।
- data.adjustments.mileage.adjustment: बाजार के औसत माइलेज के साथ विशिष्ट माइलेज को समायोजित करें।
- data.period: उपयोग किए गए बाजार डेटा की समय सीमा। तिथियाँ ISO प्रारूप में हैं; नमूने में कोई समय क्षेत्र निर्दिष्ट नहीं है।
नमूना प्रतिक्रिया में मुद्रा निर्दिष्ट नहीं की गई है। संख्यात्मक मानों को बिना इकाई के राशियों के रूप में मानें और अपने उत्पाद के स्थान या API पृष्ठ नोट्स के साथ मुद्रा प्रबंधन को संरेखित करें। धारणाओं से बचें; जब संदेह हो, तो आंतरिक उपयोगकर्ताओं के लिए स्पष्ट रूप से इकाइयों को लॉग और प्रदर्शित करें।
2) निर्माताओं को प्राप्त करें
विधि: GET
URL: https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4059/get-makers
विवरण: सभी समर्थित वाहन निर्माताओं को पुनः प्राप्त करें।
इस अंत बिंदु के लिए कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं। केवल Authorization हेडर के साथ भेजें।
आधिकारिक कर्ल:
3) मॉडल प्राप्त करें
विधि: GET
URL: https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4060/get-models
विवरण: एक विशिष्ट निर्माता से संबंधित सभी मॉडलों को पुनः प्राप्त करें।
आवश्यक क्वेरी पैरामीटर:
- maker (string): निर्माता का नाम। उदाहरण: audi
आधिकारिक कर्ल:
PHP एकीकरण: VIN द्वारा बाजार मूल्य प्राप्त करें और LTV की गणना करें
निम्नलिखित PHP स्निपेट “Get Vehicle price data” अंत बिंदु को कॉल करता है, त्रुटियों को संभालता है, और एक बुनियादी लोन-टू-वैल्यू अनुपात की गणना करने के लिए औसत मूल्य का उपयोग करता है। आप इसे अपने वित्तपोषण पाइपलाइन में एक नियंत्रक या कार्य चरण में डाल सकते हैं।
<?php
$apiKey = 'YOUR_API_KEY';
$vin = '3FMTK3SU3NMA08229'; // दस्तावेज़ों से उदाहरण VIN
$url = 'https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data?vin=' . urlencode($vin);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlErr = curl_error($ch);
curl_close($ch);
if ($curlErr) {
throw new RuntimeException('cURL error: ' . $curlErr);
}
if ($httpCode < 200 || $httpCode >= 300) {
throw new RuntimeException('HTTP error code: ' . $httpCode . ' body=' . $response);
}
$payload = json_decode($response, true);
if (!isset($payload['status']) || $payload['status'] !== true) {
throw new RuntimeException('API status not OK: ' . $response);
}
// Extract fields you actually need
$data = $payload['data'] ?? [];
$mean = $data['mean'] ?? null;
$stdev = $data['stdev'] ?? null;
$count = $data['count'] ?? null;
$mileageAdj = $data['adjustments']['mileage']['adjustment'] ?? 0;
// Example: compute a conservative collateral value by applying a buffer (e.g., -0.5 stdev)
$bufferedValue = null;
if (is_numeric($mean) && is_numeric($stdev)) {
$bufferedValue = $mean - 0.5 * $stdev + $mileageAdj;
}
// Example LTV: requested_loan / bufferedValue
$requestedLoan = 25000.00;
$ltv = null;
if ($bufferedValue && $bufferedValue > 0) {
$ltv = $requestedLoan / $bufferedValue;
}
// Output or store results
$result = [
'vin' => $data['vin'] ?? $vin,
'vehicle' => $data['vehicle'] ?? null,
'mean' => $mean,
'stdev' => $stdev,
'count' => $count,
'mileage_adjustment' => $mileageAdj,
'buffered_value' => $bufferedValue,
'requested_loan' => $requestedLoan,
'ltv' => $ltv
];
header('Content-Type: application/json');
echo json_encode($result, JSON_PRETTY_PRINT);
JavaScript उदाहरण (Node.js या आधुनिक रनटाइम)
यह उदाहरण fetch का उपयोग करके उसी अंत बिंदु को कॉल करता है और वित्तपोषण लॉजिक में उपयोग किए गए प्रमुख क्षेत्रों को लॉग करता है।
import fetch from 'node-fetch';
const API_KEY = 'YOUR_API_KEY';
const VIN = '3FMTK3SU3NMA08229';
const url = `https://zylalabs.com/api/3623/estimated-vehicle-market-value-api/4058/get-vehicle-price-data?vin=${encodeURIComponent(VIN)}`;
const res = await fetch(url, {
method: 'GET',
headers: {
'Authorization': `Bearer ${API_KEY}`
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status} - ${text}`);
}
const payload = await res.json();
if (!payload.status) {
throw new Error('API reported non-success status');
}
const data = payload.data || {};
const mean = data.mean;
const stdev = data.stdev;
const count = data.count;
const avgMileage = data.adjustments?.mileage?.average;
const inputMileage = data.adjustments?.mileage?.input;
const mileageAdj = data.adjustments?.mileage?.adjustment;
console.log({
vin: data.vin,
vehicle: data.vehicle,
mean,
stdev,
count,
period: data.period,
averagePrice: data.prices?.average,
lowBand: data.prices?.below,
highBand: data.prices?.above,
distributionBuckets: data.prices?.distribution?.length,
mileage: { avgMileage, inputMileage, mileageAdj }
});
निर्माताओं और मॉडलों का उपयोग करके इनपुट को मान्य करना
जब आपके पास VIN नहीं है लेकिन फिर भी ग्राहक सबमिशन (जैसे, वित्तपोषण फॉर्म में निर्माता/मॉडल ड्रॉपडाउन) को पूर्व-मान्य करना चाहते हैं, तो खोज अंत बिंदुओं का उपयोग करें।
- निर्माताओं को प्राप्त करें: समर्थित निर्माताओं को लौटाता है। कोई पैरामीटर प्रलेखित नहीं हैं; केवल Authorization हेडर के साथ कॉल करें।
- मॉडल प्राप्त करें: निर्माता की आवश्यकता होती है। उदाहरण: maker=audi।
ये हल्के कॉल आपको मूल्यांकन करने से पहले अमान्य इनपुट को कम करने में मदद करते हैं और शोर अंडरराइटिंग लॉग को कम करते हैं।
आपका समय बचाने वाले परिचालन विवरण
- प्रमाणीकरण: प्रत्येक अनुरोध Authorization: Bearer YOUR_API_KEY का उपयोग करता है।
- HTTP अर्थशास्त्र: सभी प्रलेखित अंत बिंदु GET हैं। इन्हें इडेम्पोटेंट और सुरक्षित मानें; आप अस्थायी विफलताओं पर पुनः प्रयास कर सकते हैं।
- कोटा और बिलिंग: Zyla API Hub सदस्यता + कोटा का उपयोग करता है, न कि पे-पर-कॉल। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। हब पर पहली बार उपयोग के लिए, आपको आमतौर पर 7-दिन का परीक्षण या शुरू करने के लिए 50 अनुरोध देखने को मिलेंगे; लिस्टिंग पर पुष्टि करें।
- कैशिंग: VIN मूल्यांकन आमतौर पर वास्तविक समय में नहीं होते हैं जैसे कोट; उचित अवधि के लिए VIN द्वारा कैशिंग पर विचार करें। प्रतिक्रिया में एक अवधि सरणी शामिल होती है जो अनुमान को सूचित करने वाली बाजार डेटा विंडो को इंगित करती है।
- मुद्रा और इकाइयाँ: नमूना संख्यात्मक मूल्य मानों को बिना स्पष्ट मुद्रा के दिखाता है; अपने आंतरिक प्रतिनिधित्व को मुद्रा-सचेत रखें और किसी भी UI में स्पष्ट रूप से इकाइयों को प्रदर्शित करें। माइलेज मान संख्यात्मक हैं; जब तक आपके उत्पाद विनिर्देशों में पुष्टि न हो, तब तक इकाई मानने से बचें।
- त्रुटि प्रबंधन: HTTP स्थिति कोड और शीर्ष स्तर के "status" बूलियन की जांच करें। जब मौजूद हो, तो अवलोकन के लिए "message" को लॉग करें।
- वितरण बकेट: ये प्रतिशत-आधारित अंडरराइटिंग का समर्थन करते हैं (जैसे, अनुरोधित ऋण को उच्च बैंड या 75वें प्रतिशत से अधिक नहीं होना चाहिए)। बकेट को गिनती के साथ न्यूनतम/अधिकतम रेंज के रूप में प्रदान किया जाता है।
प्रतिक्रिया क्षेत्रों के साथ वित्तपोषण कार्यप्रवाह को भेजें
यहाँ एक व्यावहारिक LTV गेट है जिसे आप तुरंत मूल्यांकन अंत बिंदु से क्षेत्रों का उपयोग करके लागू कर सकते हैं:
- आवेदक के VIN के साथ Get Vehicle price data को कॉल करें।
- मूल्य औसत में से मानक विचलन का एक अंश घटाकर, साथ ही यदि मौजूद हो तो माइलेज समायोजन जोड़कर एक संवेदनशील संपार्श्विक मूल्य की गणना करें।
- LTV = requested_loan / conservative_value की गणना करें।
- यदि LTV आपके थ्रेशोल्ड के नीचे है तो स्वचालित रूप से स्वीकृत करें; अन्यथा मैनुअल समीक्षा के लिए रूट करें और आउटलेयर का न्याय करने के लिए वितरण बकेट प्रदर्शित करें।
गिनती और निश्चितता की उपस्थिति आपको यह तय करने में मदद करती है कि क्या नमूना आकार या विश्वास आगे की जांच के लायक है इससे पहले कि आप क्रेडिट जारी करें।
AI एजेंटों से MCP के माध्यम से API को कॉल करें
यदि आप MCP-संगत उपकरणों (Claude Code, Cursor, Windsurf, आदि) का उपयोग करते हैं, तो आप एक एजेंट को बिना किसी विशेष HTTP कोड के इस API तक पहुंचने दे सकते हैं। अपने ग्राहक को MCP अंत बिंदु पर इंगित करें MCP अपने Zyla API कुंजी (https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY) का उपयोग करके। एक MCP सत्र के भीतर, लिस्टिंग को खोजने के लिए प्रदान किए गए उपकरणों का उपयोग करें (जैसे, लिस्टिंग आईडी 3623 को संदर्भित करते हुए get_api_info उपकरण के माध्यम से) और फिर लक्षित ऑपरेशन को लागू करें (जैसे, Get Vehicle price data अंत बिंदु आईडी 4058 को vin पैरामीटर के साथ कॉल करें)। इससे एजेंट का रनटाइम स्टेटलेस रहता है और आपको कार्यों के बीच समान Zyla क्रेडेंशियल्स का पुन: उपयोग करने की अनुमति मिलती है।
परीक्षण चेकलिस्ट
- अपने Authorization हेडर और नेटवर्क पथ को मान्य करने के लिए आधिकारिक कर्ल का एक बार उपयोग करें।
- विकास के दौरान कच्चे JSON को लॉग करें ताकि डोमेन वस्तुओं के लिए मैप करने से पहले क्षेत्रों को सत्यापित किया जा सके।
- सुनिश्चित करें कि आपका वित्तपोषण गणित null या अनुपस्थित क्षेत्रों को सुचारू रूप से संभालता है (जैसे, यदि समायोजन अनुपस्थित हैं)।
- एक ही अंडरराइटिंग सत्र में दोहराए गए कॉल को कम करने के लिए प्रति VIN कैश करें।
- हमेशा अपने निर्णय रिकॉर्ड में संग्रहीत मूल्यांकन के साथ अवधि सरणी को रिकॉर्ड करें।
उपयोगी लिंक
- Zyla API Hub पर अनुमानित वाहन बाजार मूल्य API
- Zyla API Hub — एक ही खाता और कुंजी के साथ 10,000 से अधिक सार्वजनिक APIs का अन्वेषण करें
अक्सर पूछे जाने वाले प्रश्न
1) मुझे मूल्यांकन अंत बिंदु को कॉल करने के लिए न्यूनतम क्या चाहिए?
केवल VIN को क्वेरी पैरामीटर के रूप में और Authorization: Bearer YOUR_API_KEY हेडर।
2) क्या मैं बिना VIN के निर्माताओं और मॉडलों को देख सकता हूँ?
हाँ। निर्माताओं को प्राप्त करें (कोई प्रलेखित पैरामीटर नहीं) और निर्माता क्वेरी पैरामीटर (जैसे, maker=audi) के साथ मॉडल प्राप्त करें ताकि फॉर्म इनपुट को बनाने या मान्य करने के लिए।
3) मुझे prices.average बनाम mean की व्याख्या कैसे करनी चाहिए?
नमूने में, prices.average और mean एक ही संख्यात्मक मान साझा करते हैं। कोर गणित के लिए mean का उपयोग करें और वित्तीय निर्णयों के लिए संवेदनशील बफर लागू करने के लिए stdev और वितरण के साथ संयोजन करें।
4) क्या मूल्य मान किसी मुद्रा से जुड़े हैं?
नमूना प्रतिक्रिया मुद्रा निर्दिष्ट नहीं करता है। उन्हें संख्यात्मक राशियों के रूप में मानें और अपने सिस्टम के मुद्रा संदर्भ के साथ संरेखित करें। ग्राहक-फेसिंग आउटपुट के लिए, अपने उत्पाद विनिर्देशों के अनुसार स्पष्ट रूप से मुद्रा लेबल करें।
5) एक्सेस और बिलिंग के मूल बातें क्या हैं?
Zyla API Hub सदस्यता + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। पहली बार हब के उपयोग के लिए, आपको आमतौर पर शुरू करने के लिए 7-दिन का परीक्षण या 50 अनुरोध देखने को मिलेंगे; हमेशा वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। कोई मुफ्त योजना नहीं।
क्या आप इसे अपने अंडरराइटिंग स्टैक में वायर करने के लिए तैयार हैं? अपना खाता बनाएं, एक API कुंजी प्राप्त करें, और एकीकरण भेजें: पंजीकरण करें। आप अनुमानित वाहन बाजार मूल्य API का अन्वेषण और सदस्यता ले सकते हैं और Zyla API Hub पर अन्य लिस्टिंग के साथ विस्तार करते रहें।
