Методы API
Список методов

Средняя цена на автомобили

key
Ключ доступа к API
marka
Марка автомобиля (обязательный, по справочнику http://auto.ru)
model
Модель автомобиля (обязательный, по справочнику http://auto.ru)
year
Год автомобиля (обязательный)
gen
Поколение
volume
Объем двигателя автомобиля
horse
Лошадиные силы
kpp
КПП:
1 - механ
2 - автомат, робот, вариатор
regionid
Идентификатор региона для фильтрации (необязательно)
Метод получения справочника - offersregion

Примеры запроса:

PHP
Python
C#
                        
// Входные данные
$url = "https://data.tronk.info/avgcarprice.ashx";
$date_from = new DateTime("1970-1-1");
$date_to = new DateTime("1970-1-2");
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "marka" => "MARK",
    "model" => "model",
    "year" => 1900,
    "gen" => "C3 (1982—1988)",
    "volume" => 1.8,
    "horse" => 75,
    "kpp" => 1,
    "regionid" => 2
);

$get_params = http_build_query($request_params);

// Запрос к серверу
$response = file_get_contents($url."?".$get_params);
// Преобразование ответа
$result = json_decode($response);
                        
                    
                        
import datetime

url = "https://data.tronk.info/avgcarprice.ashx"

# входные данные
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "marka": "MARK",
    "model": "Model",
    "year": 1900,

    # Необязательные
    "gen" => "C3 (1982—1988)"
    "volume": 1.8,
    "horse" => 75,
    "kpp" => 1,
    "regionid" => 2
}

# отправка запроса
response = requests.post(
    url=url,
    params=params,
)

# преобразование ответа к словарю
data = response.json()
                        
                    
                        
using Newtonsoft.Json;
class Program
{
    static async Task Main(string[] args)
    {
        string end_point = "https://data.tronk.info/avgcarprice.ashx";

        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "marks", "MARK" },
            { "model", "Model" },
            { "year", "1900" },

            // Необязательные
            { "gen", "C3 (1982—1988)"},
            { "volume", "1.8" },
            { "horse", "75"},
            {"kpp", "1"},
            {"regionid", "2"}
        };

        string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
        string url = $"{end_point}?{url_params}";

        HttpClient client = new();
        string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();

        var result = JsonConvert.DeserializeObject(response_body);
    }
}
                        
                    

Результат вызова метода:

Описание возвращаемого JSON

start DateTime
Дата и время создание запроса
end DateTime
Дата и время окончания запроса
marka String
Марка автомобиля по которому запрашивается информация
model String
Модель автомобиля по которому запрашивается информация
year String
Год автомобиля по которому запрашивается информация
gen String
Поколение
volume Double
Объем двигателя автомобиля
horse Int
Лошадиные силы
kpp
КПП Int
error Boolean
Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
result Object
Объект с результатом возвращаемого запроса. Равен null, если по заданным параметрам ничего не найдено
average Double
Средняя цена
offers_count Int
Кол-во объявлений в расчете
offers Object array
Объявления расчета
price Double
Цена из объявления
distance Double
Пробег из объявления
url String
Ссылка на объявление

Результат вызова метода в случае ошибки:

  • Закончился доступ или запросы (Проверить доступ)

  • Нет необходимых прав

  • Некорректный ключ доступа или пользователь не создан

  • Не указан параметр марка автомобиля

  • Не указан параметр модель автомобиля

  • Не указан параметр год автомобиля
  • Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    marka String
    Марка автомобиля по которому запрашивается информация
    model String
    Модель автомобиля по которому запрашивается информация
    year String
    Год автомобиля по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и false в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки