Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия VK: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поиск видеоvideo_search | Ищите видео VK по ключевому слову: название, длительность, дата публикации, просмотры, лайки, репосты и пользователь или сообщество, которому принадлежит видео. | $16 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите посты со стены пользователя или сообщества VK в формате JSON. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API VK?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
video_searchПоиск видео Ищите видео VK по ключевому слову: название, длительность, дата публикации, просмотры, лайки, репосты и пользователь или сообщество, которому принадлежит видео. Поиск идёт только по видео, без постов на стене, групп и профилей, а медиафайлы не скачиваются. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $16 за 1 000 запросов | id · url · title · text · media_type · duration_sec · duration_seconds · posted_at · view_count · like_count · repost_count · cover_image_url · owner_id · owner_url · platform |
user_postsПосты пользователя Получите посты со стены пользователя или сообщества VK в формате JSON. Для каждого поста возвращаются текст, ссылки на медиа, лайки, комментарии, репосты, просмотры и тип автора. Передайте короткое имя, числовой ID сообщества или владельца либо ссылку на стену vk.com. Закрытые профили недоступны. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · posted_at · like_count · comment_count · repost_count · view_count · media_urls · author_id · author_name · author_type · author_url · author_avatar · platform |
Что означают параметры действия video_search в API VK?
Ищите видео VK по ключевому слову: название, длительность, дата публикации, просмотры, лайки, репосты и пользователь или сообщество, которому принадлежит видео. Поиск идёт только по видео, без постов на стене, групп и профилей, а медиафайлы не скачиваются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос для действия video_search. Параметр ищет только видео; общий текстовый поиск по постам на стене, группам или профилям пользователей он не выполняет.Официальная схема VK: длительность видео и владелец — В официальной схеме объекта видео VK отдельно указаны ID видео, `owner_id` и пользователь, загрузивший видео, а длительность определяется в секундах. Это поясняет поля видео, но не означает, что этот эндпоинт поддерживает другие возможности официальной схемы. · Проверено
Что означают параметры действия user_posts в API VK?
Получите посты со стены пользователя или сообщества VK в формате JSON. Для каждого поста возвращаются текст, ссылки на медиа, лайки, комментарии, репосты, просмотры и тип автора. Передайте короткое имя, числовой ID сообщества или владельца либо ссылку на стену vk.com. Закрытые профили недоступны.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Целевой публичный профиль или сообщество для действия user_posts. Принимает короткое имя, числовой ID сообщества (club), числовой ID владельца или полный URL профиля или стены (например, ссылки vk.com), а не только личные имена пользователей.Официальная схема VK: записи на стенах пользователей и сообществ — Официальный метод wall.get определяет объекты как стены пользователей или сообществ и поясняет использование коротких адресов. Это уточняет, к какой сущности относится username; официальные параметры, аутентификация и методы записи не считаются возможностями этого эндпоинта. · Проверено
Как использовать API VK
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"vk","action":"video_search","params":{"keyword":"<keyword>"}}'
Вопросы об API VK
Какие данные можно получить через API VK?
Укажите в platform значение vk. В текущем каталоге: поиск видео и посты пользователя. Эти названия действий соответствуют разным объектам или представлениям VK; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса video_search к платформе VK?
Поисковый запрос для действия video_search. Параметр ищет только видео; общий текстовый поиск по постам на стене, группам или профилям пользователей он не выполняет. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть video_search на платформе VK?
Объявленная схема включает title, text, media_type и duration_sec. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия VK возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.