WeChat Channels API
WeChat Channels는 WeChat 안의 숏폼 동영상 피드입니다. search는 키워드로 동영상을 찾고, user_posts는 계정의 최신 동영상을 나열합니다. video는 숫자 ID로 동영상 하나를 조회하고, profile은 계정의 공개 정보를 조회합니다.
user_posts와 video는 각 행의 ID로 연결해 사용합니다. id는 video의 object_id로, author_username(v2_...@finder)은 user_posts의 username으로 쓰입니다. 검색 결과 행에는 두 ID가 모두 없으므로 검색 결과를 video나 user_posts로 열 수 없습니다. 동영상 파일 링크는 약 하루 뒤 만료되며, 각 파일의 앞부분은 암호화되어 있어 video_decode_key로 복호화합니다.
플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 WeChat Channels 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | keyword로 WeChat Channels 동영상을 검색해 약 10개 결과가 담긴 한 페이지를 받습니다. | 요청 1,000개당 $60 | 정상 |
동영상 상세 정보video | object_id로 WeChat Channels 동영상 하나를 읽습니다. | 요청 1,000개당 $6.81 | 정상 |
사용자 게시물user_posts | username(v2_...@finder ID)으로 WeChat Channels 계정 하나의 최신 동영상 15개를 나열합니다. | 요청 1,000개당 $46 | 정상 |
프로필profile | v2_...@finder ID로 WeChat Channels 계정을 조회합니다. | 요청 1,000개당 $8 | 정상 |
댓글comments | 숫자 ID나 공유 링크로 WeChat Channels 동영상 하나의 최상위 댓글을 페이지당 최대 25개까지 읽습니다. | 요청 1,000개당 $8 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
WeChat Channels 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색
| keyword | — | Sync 응답 | — | 요청 1,000개당 $60 | search_rank · title · cover_url · duration_sec · duration_seconds · posted_at · like_count · author_name · author_avatar_url · author_is_verified · platform |
video동영상 상세 정보
| object_id | — | Sync 응답 | — | 요청 1,000개당 $6.81 | id · author_username · author_name · title · description · posted_at · like_count · collect_count · share_count · comment_count · duration_sec · duration_seconds · video_width · video_height · cover_url · video_url · video_decode_key · platform |
user_posts사용자 게시물
| username | — | Sync 응답 | — | 요청 1,000개당 $46 | id · author_username · author_name · title · description · posted_at · like_count · collect_count · share_count · comment_count · duration_sec · duration_seconds · video_width · video_height · cover_url · video_url · video_decode_key · platform |
profile프로필 v2_...@finder ID로 WeChat Channels 계정을 조회합니다. 표시 이름, 소개, 아바타, 지역, 동영상 및 컬렉션 수, 라이브 방송 시간, 인증 설명, 공식 계정 같은 연결된 WeChat 계정을 가져옵니다. Channels 프로필은 대개 팔로워 수를 숨기므로 | username | — | Sync 응답 | — | 요청 1,000개당 $8 | username · display_name · bio · avatar_url · region · follower_count · post_count · collection_count · live_duration_hours · verified_reason · linked_accounts · platform |
comments댓글 숫자 ID나 공유 링크로 WeChat Channels 동영상 하나의 최상위 댓글을 페이지당 최대 25개까지 읽습니다. 각 댓글에는 텍스트, 좋아요, 시간, 작성자의 IP 지역, 이름, 아바타가 포함되며, Channels 계정이 있는 경우 계정 ID도 포함됩니다. next_page_token으로 다음 페이지를 가져옵니다. | object_id | page_token | Sync 응답 | 호출 한 번에 최대 25행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $8 | id · text · like_count · posted_at · author_username · author_name · author_avatar_url · ip_location · next_page_token · platform |
WeChat Channels search 파라미터는 각각 무엇을 의미하나요?
keyword로 WeChat Channels 동영상을 검색해 약 10개 결과가 담긴 한 페이지를 받습니다. 각 결과에는 제목, 커버, 재생 시간, 좋아요, 게시 시각, 작성자의 이름·아바타·인증 여부가 포함됩니다. 검색 결과에는 동영상 ID나 계정 ID가 없으므로 video나 user_posts에 전달할 수 없습니다.
keyword필수search에 사용할 WeChat Channels 검색어입니다(예:coffee). 중국어 검색어가 보통 더 많은 동영상과 일치합니다. 한 번 호출하면 동영상 약 10개가 담긴 한 페이지를 반환합니다.
WeChat Channels video 파라미터는 각각 무엇을 의미하나요?
object_id로 WeChat Channels 동영상 하나를 읽습니다. object_id에는 user_posts 행에서 반환된 숫자 ID나 동영상 공유 링크(https://weixin.qq.com/sph/…)를 사용합니다. 제목, 설명, 작성자, 게시 시각, 좋아요·저장·공유·댓글 수, 재생 시간, 프레임 크기, 커버, 유효 기간이 있는 동영상 파일 링크와 복호화 키를 가져옵니다. 공유 링크로 읽으면 title, video_width, video_height가 누락될 수 있으며, description에 게시물 전체 텍스트가 담깁니다. like_count와 collect_count는 10,000을 넘으면 백 단위까지만 정확하고 항상 02로 끝나며, 100,000 이상이면 항상 100002입니다. share_count는 정확한 값이며, comment_count는 10,000을 넘으면 백 단위까지만 제공되어 02로 끝나는 경우가 있고 그 외에는 정확합니다. 파일 링크는 약 하루 후 만료됩니다.
object_id필수video에 사용할 WeChat Channels 동영상 하나의 숫자 ID(예:15039881603147501275)로,user_posts또는video행의id에서 가져오거나 동영상 공유 링크(https://weixin.qq.com/sph/...)를 입력합니다. 검색 결과 행에는 둘 다 없습니다. 다른 형식은 과금 전에 거부됩니다.WeChat 오픈 문서: Channels 동영상의 고유 ID인 feedId — WeChat 개발자 문서에 따르면 미니 프로그램은 feedId로 Channels 동영상을 열며, 작성자는 이 ID를 Channels 어시스턴트에서 복사합니다. 이 자료는 모든 Channels 동영상에 고유 ID가 있다는 점만 확인해 줍니다. 이 API의 object_id는 user_posts 또는 video 행에서 가져오는 숫자로만 된 다른 형식이므로 feedId와 바꿔 쓸 수 없습니다. · 확인일
WeChat Channels user_posts 파라미터는 각각 무엇을 의미하나요?
username(v2_...@finder ID)으로 WeChat Channels 계정 하나의 최신 동영상 15개를 나열합니다. 각 동영상에는 ID, 제목, 설명, 게시 시각, 좋아요·저장·공유·댓글 수, 재생 시간, 프레임 크기, 커버, 그리고 복호화에 필요한 키와 함께 제공되는 유효 기간이 있는 동영상 파일 링크가 포함됩니다. 계정 ID는 닉네임이 아닙니다.
username필수user_posts에 사용할 WeChat Channels 계정 ID로,v2_...@finder형식입니다.user_posts또는video행의author_username에서 가져오거나, 채널 페이지에 표시되는sph로 시작하는 채널 ID(예:sphi9BjV8GK0Zsl)를 입력합니다. 닉네임이 아니며, 검색 결과 행에는 포함되지 않습니다. 다른 형식은 과금 전에 거부됩니다.WeChat 오픈 문서: Channels 계정 ID(finderUserName) — WeChat 개발자 문서에 따르면 finderUserName은 Channels 계정 ID이며, 작성자는 Channels 어시스턴트 홈 화면에서 이를 확인할 수 있습니다. 이 자료는 Channels 계정에 닉네임과 별개인 ID가 있다는 점만 확인해 줍니다. 이 API의 username은 user_posts 또는 video 행에서 가져오는 v2_...@finder 형식의 계정 ID이며, 해당 홈 화면의 ID와 바꿔 쓸 수 없습니다. · 확인일
WeChat Channels profile 파라미터는 각각 무엇을 의미하나요?
v2_...@finder ID로 WeChat Channels 계정을 조회합니다. 표시 이름, 소개, 아바타, 지역, 동영상 및 컬렉션 수, 라이브 방송 시간, 인증 설명, 공식 계정 같은 연결된 WeChat 계정을 가져옵니다. Channels 프로필은 대개 팔로워 수를 숨기므로 follower_count는 자주 누락되며, 좋아요·즐겨찾기·공유 총합은 제공되지 않습니다.
username필수profile용 WeChat Channels 계정 ID입니다.user_posts또는video행의author_username에서 가져온v2_...@finder형식, 또는 채널 페이지에 표시되는sph로 시작하는 채널 ID(예:sphi9BjV8GK0Zsl)를 받습니다. 닉네임이 아니며, 검색 결과 행에는 이 값이 없습니다.
WeChat Channels comments 파라미터는 각각 무엇을 의미하나요?
숫자 ID나 공유 링크로 WeChat Channels 동영상 하나의 최상위 댓글을 페이지당 최대 25개까지 읽습니다. 각 댓글에는 텍스트, 좋아요, 시간, 작성자의 IP 지역, 이름, 아바타가 포함되며, Channels 계정이 있는 경우 계정 ID도 포함됩니다. next_page_token으로 다음 페이지를 가져옵니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태object_id필수- 댓글을 가져올 WeChat Channels 동영상의 숫자 ID(예:
15039881603147501275)로,user_posts또는video행의id에서 가져옵니다. 동영상 공유 링크(https://weixin.qq.com/sph/...)도 사용할 수 있습니다. page_token선택comments의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 같은 동영상에 대해 이전 응답의next_page_token을 받은 그대로 다시 전달하세요. 각 페이지는 호출 1건이며, 마지막 페이지에는next_page_token이 없습니다.
WeChat Channels 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":"wechat_channels","action":"search","params":{"keyword":"<keyword>"}}'
WeChat Channels API 자주 묻는 질문
WeChat Channels API로 무엇을 가져올 수 있나요?
platform을 wechat_channels 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 동영상 상세 정보, 사용자 게시물, 프로필 및 댓글입니다. 각 액션 이름은 서로 다른 WeChat Channels 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
WeChat Channels search 요청에는 어떤 입력이 필요한가요?
search에 사용할 WeChat Channels 검색어입니다(예: coffee). 중국어 검색어가 보통 더 많은 동영상과 일치합니다. 한 번 호출하면 동영상 약 10개가 담긴 한 페이지를 반환합니다. params 안의 keyword 필드로 전달하세요.
WeChat Channels search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 search_rank, title, cover_url 및 duration_sec입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 WeChat Channels 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.