API, интеграция

Ссылка на API

https://pixeloff.ru/api/v2.php?k=вашключ&u=ссылканаобъявление

При первом запросе API запускается обработка (status=searching) объявления, указанного в параметре u. При последующих запросах к API с теми же параметрами обработка уже не инициируется, а просто выводится результат действующей обработки.

Пока идёт обработка (очистка фото), будет возвращаться status=processed, когда обработка завершится — status примет значение done и станут доступны ссылки на очищенные фото.

Параметры запроса

ПараметрОписание
kКлюч доступа. Укажите ваш ключ доступа. Для работы API ключ должен иметь положительный баланс.
uURL объявления. Ссылка на объявление. Рекомендуется использовать urlencode.

Данные ответа

ПолеТипОписание
statusstringСтатус обработки: searching — поиск; processed XX% — обработка; done — завершено; error — ошибка.
IDintegerID объявления в источнике.
api_idintegerID объявления Pixeloff.
titlestringЗаголовок объявления.
addressstringАдрес указанный в объявлении.
parametersarrayМассив параметров объявления.
descriptionstringОписание из объявления.
priceintegerСтоимость указанная в объявлении.
photosarrayМассив очищенных фотографий.
balanceintegerВаш баланс (остаток объявлений).

Пример ответа (успех)

{
  "status": "done",
  "ID": "14442053**",
  "api_id": "12345**",
  "title": "Комната 20 м² в 1-к, 3/5 эт.",
  "address": "Тюменская обл., Тюмень, мкр Войновка, Станционная ул., 36А",
  "parameters": {
    "Площадь комнаты": "20 м²",
    "Комнат в квартире": "1",
    "Этаж": "3 из 5",
    "Тип дома": "Кирпичный"
  },
  "description": "Продам комнату в общежитии блочного типа...",
  "price": "1 200 000",
  "photos": {
    "1": "https://pixeloff.ru/photos/o01_4db6d3c0.../w/",
    "2": "https://pixeloff.ru/photos/o01_544c0c26.../f/",
    "3": "https://pixeloff.ru/photos/o01_928e13b5.../m/"
  },
  "balance": "455"
}

Пример использования (PHP)

<?php
ini_set('max_execution_time', '300');

$url = "https://www.avito.ru/..."; // Ссылка на объявление
$pixeloff_key = "MY123KEY";        // Ваш ключ доступа
$maxQuery = 100;
$cnt = 0;

function getPixeloff() {
    global $url, $pixeloff_key;
    $str = file_get_contents(
        "https://pixeloff.ru/api/v2.php?k=$pixeloff_key&u=" . urlencode($url)
    );
    return json_decode($str);
}

$json = getPixeloff();
sleep(5);
while (!$json->status || ($json->status != 'done' && $json->status != 'error')) {
    sleep(3);
    $json = getPixeloff();
    if ($cnt > $maxQuery) {
        die('TimeOut Error!');
    } else {
        $cnt++;
    }
}

if ($json->status == 'done') {
    echo $json->title . "<br>";
    foreach ($json->photos as $val) {
        echo "<img src='$val' height='60'>";
    }
}
?>
Внимание! Приведённый выше код работает долго — он посылает запрос на обработку объявления и ожидает полного завершения. Если в объявлении много фотографий, обработка займёт время. Позаботьтесь о параметре max_execution_time. Рекомендуем разбить скрипт на две части: инициирующую обработку и принимающую результаты.
Внимание! Количество одновременных обработок ограничено! Нельзя запустить более 5 обработок одновременно — организуйте на вашей стороне очередь. Если нужно больше параллельных обработок — свяжитесь с поддержкой.

Таблица ошибок

КодОписаниеВычет
101Не указан ваш ключ, в параметре 'k'нет
102Не указана ссылка на объявление, в параметре 'u'нет
104Ключ указанный в параметре 'k' не найденнет
105Отрицательный баланс ключанет
120В параметре 'u' указана некорректная ссылканет
210Объявление не найденонет
220Не найдены фотографии в объявлениида
225При обработке фото произошла ошибканет
230Объявление более не актуальнода
250Неизвестная ошибка — обратитесь в поддержкунет
300Превышено количество одновременных обработокнет
500Технические неполадки. Повторите позднее...нет
501Технические неполадки с обработкой данного источниканет

Важное предупреждение

API предназначен исключительно для автоматизации и упрощения работы с объявлениями тех авторов, которые дали вам согласие на обработку/копирование/размещение принадлежащих им текстовых и фото материалов. Мы против любых нарушений прав владельцев интеллектуальной собственности!

Получая доступ, вы безоговорочно соглашаетесь с пользовательским соглашением, в рамках которого вы не имеете права обрабатывать объявления и цифровые изображения, если вами не было получено согласие их правообладателей!

← Вернуться на главную