Пример использования API

API — это программный интерфейс, позволяющий разработчикам использовать данные сервисов «Пиксель Тулс» в своих приложениях. Работа с ним происходит в 2 шага: сначала вы создаёте задачу согласно списку существующих методов, затем дожидаетесь её выполнения и получаете результат.

1. Постановка задачи

Пример задачи: собрать основные параметры для запроса [купить iphone] по региону Москва.

Код на PHP с использованием CURL:

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://tools.pixelplus.ru/api/complex_queries_analyser?key={ключ-api}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('requests' => 'купить iphone','search_system' => '1','lr' => '213','deep' => '25','geo' => '1','intent' => '1','site-type' => '1'),
));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

?>

Ответ:

{
    "report_id": "2617068"
}

2. Получение результата

Код на PHP с использованием CURL:

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://tools.pixelplus.ru/api/complex_queries_analyser?key={ключ-api}&report_id={id-задачи}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

?>

Ответ:

{
    "status": "success",
    "msg": "completed",
    "time": "1621535800",
    "cost": 1,
    "request": {
        "requests": [
            "купить iphone"
        ],
        "search_system": "1",
        "lr": 213,
        "deep": 25,
        "geo": "1",
        "intent": "1",
        "site-type": "1",
        "exceptions_words": [],
        "gruppirovka_method": 3,
        "gruppirovka_user_grouping_pow": 3,
        "user_id": "99855",
        "requests_filtered": []
    },
    "response": {
        "response": {
            "result": [
                {
                    "geo": true,
                    "local_pow": 56,
                    "vital": false,
                    "thematic_words": [
                        "цена",
                        "apple",
                        "магазин",
                        "интернет",
                        "доставка"
                    ],
                    "com": 76,
                    "rev": 20,
                    "media": 12,
                    "lex": 0,
                    "music": 0,
                    "trav": 0,
                    "classified": {
                        "1": 24,
                        "3": 36,
                        "4": 0,
                        "5": 0,
                        "9": 16,
                        "2": 0,
                        "6": 0,
                        "10": 0,
                        "11": 0,
                        "7": 0,
                        "8": 0,
                        "14": 0,
                        "12": 0,
                        "13": 0,
                        "9999": 24
                    },
                    "morda_count": null,
                    "doc_count": null,
                    "rel_url": null,
                    "site_pos": null,
                    "ws_exact": null,
                    "ws_overall": null,
                    "group": null
                }
            ],
            "dictionary": {
                "classified": {
                    "1": "Агрегаторы",
                    "3": "Интернет-магазины",
                    "4": "Контентные проекты",
                    "5": "Новости",
                    "9": "Представительства бизнесов и организаций",
                    "2": "Видео",
                    "6": "Онлайн-игры",
                    "10": "Сервисы",
                    "11": "Сообщества",
                    "7": "Порно, эротика",
                    "8": "Портал",
                    "14": "Прочее",
                    "12": "Социальные сети",
                    "13": "Ставки"
                }
            }
        }
    }
}

Со списком всех доступных методов, их параметров и ошибок вы можете ознакомиться в разделе документации к API. А если у вас возникли трудности или вы не нашли нужного метода, напишите в техническую поддержку, мы постараемся помочь.