API رایگان قیمت روز خودرو صفر
قیمت روز خودروی صفر ایرانخودرو، سایپا و برندهای خارجی به تومان، به تفکیک برند، مدل و تیپ، با فیلتر بازهی قیمت و سال ساخت. هر روز ساعت ۱۲ ظهر به وقت تهران بهروز میشود.
نمونهی کاربرد
مناسب سایتهای نمایشگاه خودرو، وبلاگهای خودرو، مقایسهگر قیمت و اپهای خرید و فروش.
آدرسهای API
| آدرس | کاربرد |
|---|---|
GET https://hodhodvision.ir/api/v1/open/prices/ | قیمت ارز، طلا، سکه و رمزارز؛ فیلتر با keys=usd,gold18 |
GET https://hodhodvision.ir/api/v1/open/prices/<key>/ | قیمت یک قلم |
GET https://hodhodvision.ir/api/v1/open/cars/ | قیمت خودرو؛ فیلتر brand, model, year, q, min_price, max_price |
GET https://hodhodvision.ir/api/v1/open/cars/brands/ | برندها و محدوده قیمت |
برندهای خودرو در API
audi— آئودی (۷ تیپ)artabanmotors— آرتابان (۱ تیپ)amico— آمیکو (۱ تیپ)avatar— آواتار (۱ تیپ)skywell— اسکایول (۱ تیپ)koda— اشکودا (۴ تیپ)mg— ام جی (۴ تیپ)mvm— ام وی ام (۱ تیپ)aventra— اونترا (۱ تیپ)opel— اپل (۳ تیپ)xtrim— اکستریم (۵ تیپ)irankhodro— ایران خودرو (۳۹ تیپ)eres— ایرس (۱ تیپ)baic— بایک (۳ تیپ)bestune— بستیون (۲ تیپ)mercedesbenz— بنز (۶ تیپ)bac— بک (۲ تیپ)bmw— بی ام و (۹ تیپ)byd— بی وای دی (۸ تیپ)beijing— بیجینگ (۲ تیپ)toyota— تویوتا (۷۵ تیپ)tigard— تیگارد (۴ تیپ)getta— جتا (۴ تیپ)jac— جک (۴ تیپ)geely— جیلی (۱ تیپ)dongfeng— دانگ فنگ (۵ تیپ)dacia— داچیا (۱ تیپ)dayun— دایون (۱ تیپ)renault— رنو (۴ تیپ)roewe— رووی (۱ تیپ)seat— سئات (۱ تیپ)ssangyong— سانگ یانگ (۳ تیپ)saipa— سایپا (۴۷ تیپ)suzuki— سوزوکی (۱۵ تیپ)citroen— سیتروئن (۲ تیپ)cheval— شوال (۲ تیپ)fardamotors— فردا موتورز (۷ تیپ)foton— فوتون (۲ تیپ)volkswagen— فولکس (۱۲ تیپ)fownix— فونیکس (۲۲ تیپ)
نمونه کد
curl
curl "https://hodhodvision.ir/api/v1/open/cars/?brand=irankhodro&limit=10"JavaScript
const r = await fetch("https://hodhodvision.ir/api/v1/open/cars/?brand=irankhodro&limit=10");
const data = await r.json();Python
import requests
print(requests.get("https://hodhodvision.ir/api/v1/open/cars/?brand=irankhodro&limit=10", timeout=15).json())PHP
<?php
$data = json_decode(file_get_contents("https://hodhodvision.ir/api/v1/open/cars/?brand=irankhodro&limit=10"), true);ویجت آماده قیمت ارز و طلا برای سایت شما
بدون برنامهنویسی: این کد را در صفحهی خود بگذارید تا جدول قیمت زنده نمایش داده شود.
<iframe src="https://hodhodvision.ir/embed/prices?keys=usd,eur,gold18,coin" width="100%" height="230" style="border:0"></iframe>
<p>منبع: <a href="https://hodhodvision.ir/prices">هدهد ویژن</a></p>شرایط استفاده
استفاده رایگان است؛ نام «هدهد ویژن» را با پیوند به hodhodvision.ir نمایش دهید. حداکثر ۱۲۰ درخواست در دقیقه برای هر IP؛ نتیجه را کش کنید.
API خبر با فیلتر دلخواه · مشخصات OpenAPI · قیمت روز خودرو
پرسشهای متداول
API قیمت خودرو رایگان است؟
بله. API قیمت خودرو هدهد ویژن رایگان است، ثبتنام و کلید نمیخواهد و CORS آزاد دارد. فقط نام «هدهد ویژن» را با پیوند نمایش دهید.
چطور قیمت خودرو را در سایت خودم نمایش دهم؟
یک درخواست GET به آدرس نمونه بزنید، JSON را بخوانید و فیلد value (یا price_toman برای خودرو) را در صفحه بگذارید. نتیجه را حداقل یک دقیقه کش کنید.
قیمت خودرو هر چند وقت بهروز میشود؟
قیمت خودرو یک بار در روز، ساعت ۱۲ ظهر به وقت تهران و قیمت ارز، طلا و رمزارز هر چند دقیقه بهروز میشود؛ فیلد updated_at زمان دقیق را میگوید.
API قیمت ارز و خودرو هدهد ویژن رایگان است؟
بله. قیمت دلار، یورو، طلا، سکه و قیمت روز خودروی صفر بهصورت رایگان، بدون ثبتنام و بدون کلید در دسترس است. تنها شرط، نمایش نام «هدهد ویژن» با پیوند به سایت است.
خروجی در چه قالبی است؟
JSON با کدگذاری UTF-8. مبلغها عدد هستند (تومان) و زمانها بهصورت ISO 8601 میآیند تا در هر زبان برنامهنویسی مستقیم استفاده شوند.
قیمتها هر چند وقت بهروز میشوند؟
قیمت ارز، طلا و سکه هر چند دقیقه و قیمت خودرو یک بار در روز، ساعت ۱۲ ظهر به وقت تهران. فیلد updated_at زمان آخرین بهروزرسانی هر قلم را نشان میدهد.
از مرورگر هم میشود صدا زد؟
بله. این API هدر CORS آزاد دارد و میتوانید مستقیم از جاوااسکریپت سایت خود فراخوانی کنید. پاسخها کش میشوند؛ لطفاً بیشتر از یک بار در دقیقه نپرسید.
محدودیت تعداد درخواست چقدر است؟
تا ۱۲۰ درخواست در دقیقه برای هر IP. بیشتر از آن پاسخ ۴۲۹ همراه با هدر Retry-After میگیرید. برای بار زیاد، نتیجه را در سرور خود کش کنید.
چطور بر اساس برند و قیمت خودرو فیلتر کنم؟
در /open/cars/ از پارامترهای brand، model، year، q، min_price و max_price استفاده کنید؛ برای صفحهبندی limit و offset. فهرست برندها در /open/cars/brands/ است.
قیمت خودرو قیمت قطعی معامله است؟
نه؛ برآورد بازار آزاد خودروی صفر است و ممکن است با قیمت واقعی معامله فرق کند. برای تصمیم خرید حتماً با نمایندگی یا فروشنده تأیید کنید.
خبر هم میتوانم از همین API بگیرم؟
خبرها در «API خبر» با کلید اختصاصی و فیلتر دلخواه ارائه میشود؛ یک روز تست رایگان دارد.
کدام قیمتها در API رایگان هست؟
دلار، یورو، پوند، درهم، تتر، طلای ۱۸ عیار، سکه امامی، نیمسکه، اونس جهانی طلا، نفت برنت، بیتکوین و اتریوم؛ همراه تغییر و درصد تغییر هر قلم.
API قیمت خودرو برای فروشگاه یا سایت نمایشگاهی مناسب است؟
بله. با برند، مدل، سال و بازه قیمت فیلتر کنید و فهرست را مستقیم در سایت خود نمایش دهید؛ فقط ذکر منبع «هدهد ویژن» با پیوند الزامی است.