API для разработчиков

Поиск гифок и стикеров с русской морфологией, исправлением раскладки и семантикой, популярное, паки и теги. REST с JSON, документация в Swagger: https://api.gifka.me/docs.

Как начать

Войдите и создайте ключ ниже. Ключ передаётся в заголовке X-Api-Key или параметре api_key.
Получите результаты: GET /v1/search?q=…, GET /v1/media/trending, GET /v1/media/{id}, GET /v1/packs, GET /v1/tags/suggest?q=….
В ответе у каждого медиа массив renditions: MP4 и WebP для показа, GIF для скачивания, WebM с альфой для стикеров. Выбирайте нужный размер сами.
Присылайте события показов и отправок в POST /v1/pingback: они улучшают ранжирование и обязательны для production-ключей.

curl "https://api.gifka.me/v1/search?q=спасибо&type=sticker&limit=10" \
  -H "X-Api-Key: gk_live_..."

curl -X POST "https://api.gifka.me/v1/pingback" \
  -H "X-Api-Key: gk_live_..." -H "Content-Type: application/json" \
  -d '{"events":[{"mediaId":"abc123def456","kind":"send","userHash":"u42"}]}'

Лимиты

Тариф	В минуту	В сутки	Условия
Без ключа	240	20 000	по IP, для проб и посетителей сайта
dev	30	1 000	сразу после создания ключа
production	300	100 000	после заявки, с атрибуцией «работает на gifka.me» и pingback
business	1 000	2 000 000	договор в рублях, SLA, без атрибуции

Заголовки X-RateLimit-Limit, X-RateLimit-Remaining и Retry-After показывают остаток и время ожидания.

Правила

Ссылки на медиа можно встраивать напрямую, кэшировать ответы не дольше суток.
Нельзя выгружать каталог целиком, перепродавать его и обучать на нём модели без отдельной лицензии.
Передавайте параметр rating под свою аудиторию; по умолчанию отдаётся контент до pg13.
Удалённые по требованию правообладателя медиа перестают отдаваться, приложение должно это учитывать.

Мои ключи

Войдите, чтобы создать ключ.