플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 VK 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
VK 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
video_search동영상 검색 키워드로 VK 동영상을 검색해 제목, 재생 시간, 게시일, 조회수, 좋아요, 리포스트, 소유 사용자 또는 커뮤니티를 확인합니다. 동영상만 검색하며 담벼락 게시물, 그룹, 프로필은 검색하지 않고, 미디어를 다운로드하지도 않습니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $16 | 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으로 가져옵니다. 각 게시물에는 텍스트, 미디어 링크, 좋아요, 댓글, 리포스트, 조회수, 작성자 유형이 포함됩니다. 짧은 이름, 숫자 club ID 또는 owner ID, vk.com 담벼락 링크를 전달합니다. 비공개 프로필에는 접근할 수 없습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | 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 |
VK video_search 파라미터는 각각 무엇을 의미하나요?
키워드로 VK 동영상을 검색해 제목, 재생 시간, 게시일, 조회수, 좋아요, 리포스트, 소유 사용자 또는 커뮤니티를 확인합니다. 동영상만 검색하며 담벼락 게시물, 그룹, 프로필은 검색하지 않고, 미디어를 다운로드하지도 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- video_search 액션의 검색어를 지정합니다. 이 파라미터는 동영상만 검색하며, 담벼락 게시물, 그룹, 사용자 프로필 전반에 대한 일반 텍스트 검색은 수행하지 않습니다.VK 공식 스키마: 동영상 길이와 소유 주체 — VK 공식 동영상 객체는 동영상 ID, `owner_id`, 업로드한 사용자를 구분하고, 길이를 초 단위로 정의합니다. 이는 동영상 필드를 설명하기 위한 것이며, 이 엔드포인트가 공식 스키마의 다른 기능을 지원한다는 의미는 아닙니다. · 확인일
VK user_posts 파라미터는 각각 무엇을 의미하나요?
사용자 또는 커뮤니티의 VK 담벼락 게시물을 JSON으로 가져옵니다. 각 게시물에는 텍스트, 미디어 링크, 좋아요, 댓글, 리포스트, 조회수, 작성자 유형이 포함됩니다. 짧은 이름, 숫자 club ID 또는 owner ID, vk.com 담벼락 링크를 전달합니다. 비공개 프로필에는 접근할 수 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- user_posts 액션의 대상 공개 프로필 또는 커뮤니티를 지정합니다. 개인 사용자 핸들뿐 아니라 짧은 이름, 숫자형 클럽 ID, 숫자형 소유자 ID, 전체 프로필/담벼락 URL(예: vk.com 링크)도 받습니다.VK 공식 스키마: 개인 및 커뮤니티 담벼락 게시물 — 공식 wall.get 엔드포인트는 대상을 개인 또는 커뮤니티의 담벼락으로 정의하고 짧은 주소 사용법을 설명합니다. 이는 username이 가리키는 대상의 의미를 명확히 하기 위한 것이며, 공식 파라미터, 인증, 쓰기 메서드를 이 엔드포인트의 기능으로 간주하지 않습니다. · 확인일
VK API 사용 방법
- 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>"}}'
VK API 자주 묻는 질문
VK API로 무엇을 가져올 수 있나요?
platform을 vk 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 동영상 검색 및 사용자 게시물입니다. 각 액션 이름은 서로 다른 VK 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
VK video_search 요청에는 어떤 입력이 필요한가요?
video_search 액션의 검색어를 지정합니다. 이 파라미터는 동영상만 검색하며, 담벼락 게시물, 그룹, 사용자 프로필 전반에 대한 일반 텍스트 검색은 수행하지 않습니다. params 안의 keyword 필드로 전달하세요.
VK video_search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, media_type 및 duration_sec입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 VK 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.