Инструменты · key

`fastcheckyoutube` Позиция канала в поиске YouTube по запросу

Ищет запрос в поиске YouTube и возвращает позицию первого видео нужного канала и ссылку на это видео. Метод синхронный: ответ приходит, когда страницы выдачи разобраны.

Стоимость: лимиты не списываются, но на аккаунте должен быть хотя бы 1 лимит
Режим: синхронный
Запросов за вызов: 1

Проверка позиции

GET /api/fastcheckyoutube

Видео считается принадлежащим каналу, если строка channel входит в название канала или в его адрес — без учёта регистра. Сначала разбирается первая страница выдачи, если там видео канала нет — следующие страницы.

Параметры query

key string обязательный

Ключ API из настроек аккаунта.
query string обязательный

Поисковый запрос — один.
channel string обязательный

Название канала или часть его адреса.

Ответ

Оба поля — объекты, где ключ — запрос из query. Если видео канала не нашлось, в обоих стоит "-".

request_position object

Запрос → позиция видео канала в выдаче (int) или "-".
channel_url object

Запрос → ссылка на найденное видео (не на канал) или "-".

GET /api/fastcheckyoutube

curl -G 'https://tools.pixelplus.ru/api/fastcheckyoutube' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'query=обзор смартфона' \
  --data-urlencode 'channel=pixelplus'

<?php
$url = 'https://tools.pixelplus.ru/api/fastcheckyoutube?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'query' => 'обзор смартфона',
    'channel' => 'pixelplus',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/fastcheckyoutube",
    params={
        "key": "ВАШ_КЛЮЧ",
        "query": "обзор смартфона",
        "channel": "pixelplus",
    },
    timeout=60,
)
print(response.json())

query обязательный Поисковый запрос — один channel обязательный Название канала или часть его адреса

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "request_position": {
        "обзор смартфона": 7
    },
    "channel_url": {
        "обзор смартфона": "https://www.youtube.com/watch?v=XXXXXXXXXXX"
    }
}

Ошибки

Код	Сообщение	Когда
`-50`	`Not set`	Не передан `query` или `channel`; имя параметра — ключ в ответе.
`-68`	`Not enough daily limits`	На аккаунте не осталось лимитов. Для тарифов с ограничением по периодам — также `-80` (час), `-81` (неделя), `-82` (месяц), `-83` (год).
`-1`	`Access denied`	Не передан `key`. HTTP-код 404.
`-2`	`Access denied`	Ключ не найден. HTTP-код 403.

Ответ с ошибкой

{
    "query": "Not set",
    "code": "-50"
}