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>®ion=<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) и он может быть равен: C API версии 1.2.2 |
|
new |
нет |
Новые или БУ: 1 - новые, 0 - все остальные (По умолчанию: все) C API версии 1.2.4 |
|
limit |
нет |
Ограничение кол-ва объявлений |
* в безлимитных тарифах ограничение запросов в глубь от текущей даты - 14 дней
Для получения кол-ва объявлений вызвать методом GET:
http://crwl.ru/api/rest/latest/get_ads_count/?api_key=<api_key>®ion=<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>®ion=<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>®ion=<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 - объявления только с фото) |
* Рекомендуется делать паузы между запросами 2 и более секунды
Источники:
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/balance/?api_key=<api_key>
|
Параметр |
Обязательный |
Значение |
|---|---|---|
|
api_key |
нет |
Ключ клиента |
Для получения списка регионов (Регионы для работы с API версии 1.2.2 и выше):
http://crwl.ru/api/rest/latest/regions/?api_key=<api_key>
|
Параметр |
Обязательный |
Значение |
|---|---|---|
|
api_key |
нет |
Ключ клиента |
Регионы:
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. Красноярский край
2499. Крым
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. Москва