Перейти к содержимому

Эндпоинтов: 15 · медиаплатформ: 7

Единый API для извлечения медиа и языковых задач

Получайте видео, фото и аудио по ссылкам TikTok, Instagram, Facebook, Pinterest, Likee, X и YouTube, распознавайте песни через Shazam, переводите текст и проверяйте изображения на небезопасный контент. Один ключ, один баланс, один формат ответа.

100 бесплатных кредитов при регистрации · без карты · действуют 30 дней

Запрос

POST/v1/media/extract

X-Api-Key: $API_KEY

{ "url": "https://www.facebook.com/reel/647537299265662" }
Ответ200 OK
X-Credits-Charged
2
X-Credits-Remaining
98
{
  "ok": true,
  "data": {
    "platform": "facebook",
    "type": "video",
    "media": [{
      "type": "video", "ext": "mp4", "quality": "720p",
      "width": 720, "height": 1280,
      "duration_seconds": 136.179,
      "size_bytes": 23526592,
      "codec": "h264", "has_audio": true,
      "url": "https://…"
    }]
  }
}
Реальный вызов media.extract с Facebook reel, сокращён для экономии места. Каждый документированный ключ присутствует всегда; отсутствующее значение — null.
  • Один ключ для всех эндпоинтов
  • Единый баланс в кредитах
  • Одинаковый конверт ответа везде
  • Стабильные машиночитаемые коды ошибок

endpoints

Эндпоинты

Эндпоинтов: 15, групп: 5 — под одним ключом и одним балансом.

Извлечение медиа

media.extract сам определяет платформу по ссылке и отвечает в одной форме. Эндпоинты платформ возвращают собственные поля платформы.

  • media.extract

    Любая ссылка TikTok, Instagram, Facebook, Pinterest, Likee или X в одном формате ответа

    POST/v1/media/extract

    Кредиты: 2

  • tiktok.extract

    Видео без водяного знака и аудиодорожка

    POST/v1/tiktok/extract

    Кредиты: 1

  • instagram.extract

    Посты, reels и карусели

    POST/v1/instagram/extract

    Кредиты: 2

  • facebook.extract

    Видео, reels, фотоальбомы и ссылочные посты

    POST/v1/facebook/extract

    Кредиты: 2

  • pinterest.extract

    Пины: фото, видео, story и карусели

    POST/v1/pinterest/extract

    Кредиты: 2

  • likee.extract

    Видео Likee без водяного знака, с обложкой и звуком

    POST/v1/likee/extract

    Кредиты: 2

  • x.extract

    Видео и фото из поста X

    POST/v1/x/extract

    Кредиты: 2

YouTube

Поиск, метаданные и аудио- или видеофайл, который отдают наши серверы.

  • youtube.search

    Результаты поиска, включая Shorts

    POST/v1/youtube/search

    Кредиты: 2

  • youtube.info

    Метаданные и варианты скачивания

    POST/v1/youtube/info

    Кредиты: 2

  • youtube.playlist

    Одна страница плейлиста: 20 названий с длительностью и id

    POST/v1/youtube/playlist

    Кредиты: 2

  • youtube.download

    Аудио в mp3 или m4a либо видео в mp4 (144p–1080p)

    POST/v1/youtube/download

    Кредиты: 10

Распознавание аудио

Определение песни по аудиофайлу.

  • shazam.recognize

    Распознавание трека из аудиофайла

    POST/v1/shazam/recognize

    Кредиты: 3

Язык

Перевод текста с определением исходного языка.

  • translate.text

    Перевод с определением языка

    POST/v1/translate

    Кредиты: 1

Модерация

Проверка, безопасно ли показывать изображение.

  • nsfw.scan

    Безопасно ли изображение? Вердикт и баллы по классам

    POST/v1/nsfw/scan

    Кредиты: 2

Кредиты за успешный запрос. Неудачные запросы не оплачиваются.

Тела запросов и поля ответа для каждого эндпоинта

how it works

Как это работает

  1. 1

    Создайте аккаунт

    Подтвердите email и создайте API-ключ; 100 бесплатных кредитов начисляются вместе с подтверждением.

  2. 2

    Отправьте один запрос

    Отправьте ссылку методом POST с ключом в заголовке X-Api-Key — в ответ придёт JSON с прямыми ссылками на медиа.

  3. 3

    Платите за использование

    Каждый запрос стоит фиксированно от 1 до 10 кредитов в зависимости от эндпоинта. Ошибки бесплатны.

code

curl, node и python

Никакого SDK. Каждый эндпоинт — один HTTP-запрос.

curl
curl -X POST https://app.qobilbek.dev/v1/media/extract \
  -H 'X-Api-Key: '"$API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.instagram.com/reel/DcMXl1IPNtB/"}'

Это POST /v1/media/extract. Все эндпоинты принимают тот же заголовок и отвечают в той же оболочке; тела запросов описаны в документации.

guarantees

На что можно опираться

Контракт, который соблюдает каждый эндпоинт, — интеграцию не придётся переписывать, когда меняется платформа.

Предсказуемые ответы

Каждый документированный ключ присутствует всегда. Отсутствующее значение — null, а не 0 и не "Unknown".

{ "ok": true, "data": { … } }

Машиночитаемые ошибки

Фиксированный код ошибки с соответствующим HTTP-статусом и request_id, который можно отправить в поддержку.

404 not_found · 429 rate_limited

Безопасные повторы

Повторите запрос с тем же Idempotency-Key в течение 24 часов — вернётся первый ответ, а не второе списание.

Idempotency-Key: <uuid>

Общий счёт команды

Организации с ролями, общим балансом и месячным лимитом расходов.

один баланс на организацию

status

Измерено, а не обещано

Страница статуса показывает измеренную доступность и задержку каждого продукта за последние 24 часа, 7, 30 и 90 дней. Отсутствующее значение — null, а не 0 или «Unknown».

Открыть страницу статуса

teams

Команды и контроль

  • Организации с ролями owner, admin, billing и member

  • Ключи с доступом к выбранным продуктам, списком IP и необязательным сроком действия

  • Месячный лимит расходов и дневные лимиты для участников

  • Журнал запросов и подписанные вебхуки

pricing

Оплата за запросы, в кредитах

У каждого эндпоинта одна фиксированная цена за запрос: от 1 до 10 кредитов. Ошибки и 429 бесплатны.

У каждой валюты свой прайс-лист; суммы не пересчитываются по текущему курсу.

Бесплатно

100

кредитов

0 сум

без карты

  • Сгорают через 30 дней после регистрации
  • Лимит скорости: 1 запр./с
Начать бесплатно

pack-2k

2 000

кредитов

6 000 сум

3 000 сум за 1 000 кредитов

  • Кредиты бессрочные
  • Лимит скорости: от 5 запр./с

pack-10k

10 000

кредитов

25 000 сум

2 500 сум за 1 000 кредитов

  • Кредиты бессрочные
  • Лимит скорости: от 10 запр./с

pack-50k

50 000

кредитов

100 000 сум

2 000 сум за 1 000 кредитов

  • Кредиты бессрочные
  • Лимит скорости: от 25 запр./с

pack-250k

250 000

кредитов

400 000 сум

1 600 сум за 1 000 кредитов

  • Кредиты бессрочные
  • Лимит скорости: от 50 запр./с

Пакеты покупаются в панели после входа. Какие способы оплаты доступны, показывает страница статуса.

Онлайн-оплата пока недоступна. Пакеты можно купить с денежного баланса; по остальным вопросам напишите в поддержку. Поддержка

Лимит скорости зависит от общего числа купленных кредитов: 1 → 5 → 10 → 25 → 50 запросов в секунду. Цены и лимиты по эндпоинтам

faq

Вопросы

Нет. При регистрации без карты даётся 100 бесплатных кредитов на 30 дней — хватит, чтобы попробовать каждый эндпоинт. Они начисляются после подтверждения email.

Единица, в которой оценивается каждый эндпоинт. Запрос стоит от 1 до 10 кредитов в зависимости от эндпоинта, неудачный запрос — бесплатно. Все цены в реальном времени — на странице «Цены».

Бесплатные кредиты сгорают через 30 дней после регистрации. У купленных кредитов срока нет.

Ссылки TikTok, Instagram и других платформ — это CDN-ссылки, подписанные источником, и мы никогда не кэшируем ответ дольше, чем живут его ссылки. Файлы YouTube отдают наши серверы по ссылке, которая работает один час.

Да. Ключи и баланс принадлежат организации. Пригласите коллег, назначьте роли и задайте месячный лимит расходов или дневной лимит для каждого участника.

1 → 5 → 10 → 25 → 50 запросов в секунду, растут вместе с общим числом купленных кредитов. При превышении возвращается 429 rate_limited, и ничего не списывается.

TikTok (без водяного знака), Instagram, Facebook, Pinterest, Likee, X и YouTube; media.extract принимает ссылку с любой из первых шести. Также есть распознавание песен через Shazam, перевод текста и модерация изображений.

Вернётся ok: false с фиксированным error.code и соответствующим HTTP-статусом: not_found (404) для удалённого поста, scope_denied (403) для закрытого аккаунта, upstream_error (502), если сбоит сама платформа. Опирайтесь на error.code, а не на текст сообщения. Удержанные за запрос кредиты возвращаются на баланс.

Один заголовок: X-Api-Key. Нет OAuth и токенов, которые надо обновлять. Ключ, переданный в query-строке, отклоняется и сразу отзывается, потому что он уже попал в логи.

Начните с 100 бесплатных кредитов

Без карты и без звонка с отделом продаж. Создайте ключ и отправьте первый запрос за минуту.

Получить API-ключ