Высокие технологии
у вас на службе
+7 (499) 409-46-56Время работы с 11:00 - 20:00

API — application programming interface

Для получения тестового доступа к API пройдите регистрацию. В тестовом режиме ограничена выдача, скрыта часть телефона и теперь вместо ссылок на объявление в демо режиме ссылка на http://crwl.ru (ввели из-за злоупотребления демо режимом).

 

Формат ответа сервера в виде (параметр format): json, xml, csv

 

Для получения объявлений вызвать методом GET:

http://crwl.ru/api/rest/latest/get_ads/?api_key=<api_key>&region=<region>&last=<hours>&source=<source>

Параметр

Обязательный

Значение

api_key

да

Ключ клиента

region

нет

Номер региона

Внимание: если номер региона не указан, результат будет содержать объявления по всей России

C API версии 1.2.2 регионы можно передавать через "," (запятую)

last

нет

За сколько последних часов требуется результат

source

нет

Из какого источника нужны данные

C API версии 1.2.2 источники можно передавать через "," (запятую)

min_date, max_date

нет

Диапазон дат за который нужны данные

DD-MM-YYYY

phone_find

нет

Максимально допустимое кол-во объявлений с одним  телефоном

min_year, max_year

нет

Год авто с … и по …

min_price, max_price

нет

Цена авто с … и по …

condition

нет

Состояние автомобиля: 1 - не битые, 2 - битые

C API версии 1.2.2

car

нет

Тип автомобиля: 1 - легковые, 2 - легкие коммерческие, 3 - грузовики и спецтехника

C API версии 1.2.2

type

нет

Есть только у 3-ого типа автомобилей (использовать совместно с car=3) и он может быть равен:

crane — Автокраны
bulldozers — Бульдозеры
autoloader — Автопогрузчики
dredge — Экскаваторы
agricultural — Сельскохозяйственная
municipal — Коммунальная
crane_hydraulics — Самопогрузчики
construction — Строительная
artic — Седельные тягачи
drags — Прицепы
trucks — Грузовики
bus — Автобусы
swapbody

C API версии 1.2.4

 

Для получения кол-ва объявлений вызвать методом GET:

http://crwl.ru/api/rest/latest/get_ads_count/?api_key=<api_key>&region=<region>&last=<hours>&source=<source>

 

Для получения данных по объявлению по url вызвать методом GET:

http://crwl.ru/api/rest/latest/get_ad/?api_key=<api_key>&url=http://krasnodar.drom.ru/lada/priora/15968102.html

Параметр

Обязательный

Значение

api_key

да

Ключ клиента

url

да

Ссылка на объявление

 

Для получения новых объявлений:

http://crwl.ru/api/rest/latest/get_new_ads/?api_key=<api_key>&region=<region>

Параметр

Обязательный

Значение

api_key

да

Ключ клиента

region

нет

Номер региона

Внимание: если номер региона не указан, результат будет содержать объявления по всей России

 

Для получения средней цены:

http://crwl.ru/api/rest/latest/get_average_price/?api_key=<api_key>&brand=<brand>&model=<model>&year=<year>

Пример: http://crwl.ru/api/rest/latest/get_average_price/?api_key=<api_key>&brand=audi&model=a4&year=2004

Параметр

Обязательный

Значение

api_key

да

Ключ клиента

brand

да

Марка

model

да

Модель

year

да

Год

region

нет

Номер региона

Внимание: если номер региона не указан, результат будет содержать объявления по всей России

 

Пример на PHP:

$api_key = [апи ключ полученный в личном кабинете];

$url= "http://crwl.ru/api/rest/latest/get_ads/?api_key=$api_key";

$result=file_get_contents($url);

$ads=json_decode($result, true);

 

Возвращаемые параметры:

dt - дата и время,
region - регион,
url - ссылка на источник,
marka - марка,
model - модель,
model_2 - модель 2,
color - цвет,
body - кузов,
transmission - тип кпп,
engine - двигатель,
enginevol - объем,
condition - состояние,
drive - привод,
run - пробег,
run_ed - единица измерения,
year - год выпуска,
modification - модификация,
phone - телефон,
fio - контактное лицо,
address - адрес,
price - цена,
viewed - кол-во просмотров,
pts_owner - владельцев,
info - описание,
horse - кол-во лошадей,
vin,
e_mail - почта,
company - 1-компания, 0-частник,
fuel - тип топлива,
photo - ссылки на фото,
latitude - широта,
longitude - долгота,
wheel - расположение руля,
complect - комплектация,
phone_find - кол-во объявлений с номером,
metro - метро,
region_Id,
average_price - средняя цена,
difference_price - отклонение от средней цены

 

Источники:

auto.ru,

trucks.auto.ru,

am.ru,

irr.ru,

mail.ru,

avito.ru,

drom.ru,

chance.ru,

autonavigator.ru,

avtobizon.ru,

bibika.ru,

kolesa.kz,

acn.kz,

autopro.am,

auto.desko.kg,

autobonus.lt,

usedauto.com.ua

Для получения объявлений вызвать методом GET:

http://crwl.ru/api/rest/real-estate/latest/get_ads/?api_key=<api_key>&region=<region>&last=<hours>&source=<source>

Параметр

Обязательный

Значение

api_key

да

Ключ клиента

region

нет

Номер региона

Внимание: если номер региона не указан, результат будет содержать объявления по всей России

регионы можно передавать через "," (запятую)

last

нет

За сколько последних часов требуется результат

source

нет

Из какого источника нужны данные

min_date, max_date

нет

Диапазон дат за который нужны данные

DD-MM-YYYY

phone_find

нет

Максимально допустимое кол-во объявлений с одним  телефоном

type

нет

тип объекта (1 - квартиры, 2 - ком.недвижимость, 3 - комнаты, 4 - дома, дачи, коттеджи)

type_ad

нет

тип объявления (1 - сдам, 2 - продам, 3 - сниму, 4 - куплю)

images_exists

нет

картинки (1 - объявления только с фото)

 

Источники:

avito.ru,

sob.ru,

cian.ru,

irr.ru,

realty.yandex.ru,

72.ru,

bn.ru,

emls.ru

 

Для получения списка регионов (Регионы для работы с API версии 1.2.2 и выше):

http://crwl.ru/api/rest/latest/regions/?api_key=<api_key>

Параметр

Обязательный

Значение

api_key

нет

Ключ клиента

 

Регионы:

1. Москва 
2. Московская область 
191. Санкт-Петербург 
192. Ленинградская область 
282. Адыгея 
308. Алтайский край 
388. Амурская область 
406. Архангельская область 
452. Астраханская область 
482. Башкортостан 
573. Белгородская область 
616. Брянская область 
662. Бурятия 
689. Владимирская область 
729. Волгоградская область 
781. Вологодская область 
815. Воронежская область 
886. Дагестан 
950. Еврейская АО 
962. Забайкальский край 
1013. Ивановская область 
1046. Ингушетия 
1060. Иркутская область 
1121. Кабардино-Балкария 
1153. Калининградская область 
1181. Калмыкия 
1192. Калужская область 
1229. Камчатский край 
1239. Карачаево-Черкесия 
1264. Карелия 
1290. Кемеровская область 
1344. Кировская область 
1397. Коми 
1434. Костромская область 
1461. Краснодарский край 
1692. Красноярский край 
1768. Курганская область 
1798. Курская область 
1832. Липецкая область 
1857. Магаданская область 
1868. Марий Эл 
1891. Мордовия 
1924. Мурманская область 
1955. Ненецкий АО 
1958. Нижегородская область 
2046. Новгородская область 
2067. Новосибирская область 
2118. Омская область 
2157. Оренбургская область 
2210. Орловская область 
2232. Пензенская область 
2276. Пермский край 
2351. Приморский край 
2415. Псковская область 
2442. Республика Алтай 
2451. Ростовская область 
2551. Рязанская область 
2584. Самарская область 
2648. Саратовская область 
2674. Сахалинская область 
2700. Саха (Якутия) 
2748. Свердловская область 
2865. Северная Осетия 
2895. Смоленская область 
2928. Ставропольский край 
3061. Тамбовская область 
3097. Татарстан 
3153. Тверская область 
3195. Томская область 
3224. Тульская область 
3273. Тыва 
3293. Тюменская область 
3336. Удмуртия 
3370. Ульяновская область 
3408. Хабаровский край 
3443. Хакасия 
3464. Ханты-Мансийский АО 
3504. Челябинская область 
3572. Чеченская республика 
3593. Чувашия 
3621. Чукотский АО 
3626. Ямало-Ненецкий АО 
3646. Ярославская область 

 

 

Регионы (Регионы для работы с API версии 1.2.1 и ниже):

21. Краснодар

20. Ростов-на-Дону

19. Ростов

18. Кострома

17. Ярославль

16. Иваново

15. Тверь

14. Владимир

13. Смоленск

12. Калуга

11. Тула

10. Рязань

9. Брянск

8. Орёл

7. Липецк

6. Тамбов                          

5. Курск

4. Белгород

3. Воронеж

2. Санкт-Петербург

1. Москва