{"openapi": "3.1.0", "info": {"title": "Hodhod Vision API", "version": "1.0.0", "summary": "API خبر فارسی و API رایگان قیمت ارز، طلا و خودرو", "description": "وب‌سرویس JSON اخبار فارسی هدهد ویژن: دسته، استان، شهر، موضوع و کلیدواژه را خودتان فیلتر کنید و خبرهای تازه را با کلید اختصاصی در سایت یا اپ خود نمایش دهید. تست رایگان یک‌روزه؛ پلن هفتگی ۵ هزار تومان؛ پرداخت آنلاین و دریافت فوری کلید.\n\nAPI رایگان قیمت ارز، طلا، سکه و قیمت روز خودروی صفر به تومان با خروجی JSON، بدون ثبت‌نام و بدون کلید؛ CORS آزاد، به‌روزرسانی هر چند دقیقه، نمونه کد curl، پایتون، PHP و جاوااسکریپت. فقط نام هدهد ویژن را با پیوند بیاورید.", "contact": {"name": "هدهد ویژن", "url": "https://hodhodvision.ir/about"}, "license": {"name": "Attribution required", "url": "https://hodhodvision.ir/free-api#terms"}}, "servers": [{"url": "https://hodhodvision.ir/api/v1"}], "externalDocs": {"description": "مستندات فارسی", "url": "https://hodhodvision.ir/news-api"}, "tags": [{"name": "free", "description": "رایگان، بدون کلید"}, {"name": "news", "description": "با کلید اختصاصی"}], "paths": {"/open/prices/": {"get": {"tags": ["free"], "summary": "قیمت ارز، طلا و سکه", "parameters": [{"name": "keys", "in": "query", "description": "فهرست کلیدها با ویرگول، مثل usd,gold", "schema": {"type": "string"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/PriceList"}}}}}}}, "/open/prices/{key}/": {"get": {"tags": ["free"], "summary": "قیمت یک قلم", "parameters": [{"name": "key", "in": "path", "description": "کلید قیمت", "schema": {"type": "string"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Price"}}}}}}}, "/open/cars/": {"get": {"tags": ["free"], "summary": "قیمت روز خودرو", "parameters": [{"name": "brand", "in": "query", "description": "کلید برند، مثل saipa", "schema": {"type": "string"}}, {"name": "model", "in": "query", "description": "کلید مدل", "schema": {"type": "string"}}, {"name": "year", "in": "query", "description": "سال ساخت", "schema": {"type": "integer"}}, {"name": "q", "in": "query", "description": "جست‌وجوی متنی", "schema": {"type": "string"}}, {"name": "min_price", "in": "query", "description": "حداقل قیمت (تومان)", "schema": {"type": "integer"}}, {"name": "max_price", "in": "query", "description": "حداکثر قیمت (تومان)", "schema": {"type": "integer"}}, {"name": "limit", "in": "query", "description": "حداکثر ۲۰۰", "schema": {"type": "integer"}}, {"name": "offset", "in": "query", "description": "جابه‌جایی", "schema": {"type": "integer"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CarList"}}}}}}}, "/open/cars/brands/": {"get": {"tags": ["free"], "summary": "برندهای خودرو", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/BrandList"}}}}}}}, "/feed/": {"get": {"tags": ["news"], "summary": "خبرهای چارچوب اشتراک", "security": [{"ApiKey": []}], "parameters": [{"name": "since", "in": "query", "description": "فقط خبرهای بعد از این seq (قدیمی به جدید)", "schema": {"type": "integer"}}, {"name": "limit", "in": "query", "description": "حداکثر 50", "schema": {"type": "integer"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/FeedPage"}}}}}}}, "/feed/{id}/": {"get": {"tags": ["news"], "summary": "یک خبر", "security": [{"ApiKey": []}], "parameters": [{"name": "id", "in": "path", "description": "شناسه خبر", "schema": {"type": "integer"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Story"}}}}}}}, "/feed/info/": {"get": {"tags": ["news"], "summary": "وضعیت کلید، آدرس و فیلترها", "security": [{"ApiKey": []}], "responses": {"200": {"description": "OK"}}}}}, "components": {"securitySchemes": {"ApiKey": {"type": "apiKey", "in": "header", "name": "X-API-Key", "description": "کلید اختصاصی؛ فقط از سرور و از آدرس ثبت‌شده."}}, "schemas": {"Attribution": {"type": "object", "properties": {"name": {"type": "string"}, "url": {"type": "string"}, "required": {"type": "boolean"}}}, "Price": {"type": "object", "properties": {"key": {"type": "string"}, "label": {"type": "string"}, "value": {"type": "number"}, "unit": {"type": "string"}, "change": {"type": "number"}, "change_pct": {"type": "number"}, "updated_at": {"type": "string", "format": "date-time"}, "stale": {"type": "boolean"}}}, "PriceList": {"type": "object", "properties": {"count": {"type": "integer"}, "updated_at": {"type": "string"}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/Price"}}, "attribution": {"$ref": "#/components/schemas/Attribution"}}}, "Car": {"type": "object", "properties": {"id": {"type": "integer"}, "brand": {"type": "string"}, "brand_key": {"type": "string"}, "model": {"type": "string"}, "model_key": {"type": "string"}, "trim": {"type": "string"}, "year": {"type": "integer"}, "price_toman": {"type": "integer"}, "prev_price_toman": {"type": "integer"}, "change_toman": {"type": "integer"}, "change_pct": {"type": "number"}, "updated_at": {"type": "string"}}}, "CarList": {"type": "object", "properties": {"total": {"type": "integer"}, "limit": {"type": "integer"}, "offset": {"type": "integer"}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/Car"}}, "attribution": {"$ref": "#/components/schemas/Attribution"}}}, "BrandList": {"type": "object", "properties": {"count": {"type": "integer"}, "results": {"type": "array", "items": {"type": "object"}}, "attribution": {"$ref": "#/components/schemas/Attribution"}}}, "Story": {"type": "object", "properties": {"id": {"type": "integer"}, "seq": {"type": "integer"}, "title": {"type": "string"}, "url": {"type": "string"}, "category": {"type": "string"}, "excerpt": {"type": "string"}, "body": {"type": "string"}, "image": {"type": "string"}, "published_at": {"type": "string", "format": "date-time"}, "province": {"type": "string"}, "keywords": {"type": "array", "items": {"type": "string"}}, "attribution": {"$ref": "#/components/schemas/Attribution"}}}, "FeedPage": {"type": "object", "properties": {"count": {"type": "integer"}, "cursor": {"type": "integer"}, "has_more": {"type": "boolean"}, "results": {"type": "array", "items": {"$ref": "#/components/schemas/Story"}}}}}}}