자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

WeChat Official Accounts API

키워드와 식별자로 공식 계정 기사, 프로필, 댓글 지표, 지수 추이를 조회해 콘텐츠 분석에 활용합니다.

키워드나 계정 식별자로 기사 데이터와 계정 정보를 가져옵니다. 개인 채팅 검색은 지원하지 않습니다.

플랫폼 가용성

24시간 상태
95%
양호

최근 30일

제공 기능

각 WeChat Official Accounts 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.

기능설명1,000건당24시간 상태
게시글 검색article_search영문 문서가 제공되는 API로 키워드를 이용해 WeChat 공식 계정 기사를 호출당 최대 400개까지 검색합니다.요청 1,000개당 $8정상
글 상세 정보article_detailWeChat 공식 계정 기사 하나의 전체 본문을 일반 텍스트와 원본 HTML로 가져옵니다.요청 1,000개당 $5.56양호 · 상태 100%
계정 검색account_search키워드로 WeChat 공식 계정을 호출당 최대 400개까지 조회합니다.요청 1,000개당 $16양호 · 상태 100%
미니 프로그램 검색mini_program_search키워드로 WeChat 미니 프로그램을 찾습니다.요청 1,000개당 $5.56정상
검색어 추천search_suggestions키워드에 대해 WeChat이 제공하는 자동 완성 추천어와 반환된 추천어 개수를 가져옵니다.요청 1,000개당 $5.56정상
계정 상세 정보account_profileWeChat 공식 계정 프로필을 JSON으로 가져옵니다.요청 1,000개당 $8정상
계정 운영 주체account_principalWeChat 공식 계정의 등록 주체를 읽습니다.요청 1,000개당 $5.56정상
계정 게시글account_articlesWeChat 공식 계정 하나의 기사 이력을 가져옵니다.요청 1,000개당 $8사용 가능 · 상태 83%
오늘 발행된 계정 게시글account_today_articlesWeChat 공식 계정 하나가 오늘 발행한 기사를 추적하며, 각 기사의 제목, 링크, 커버, 게시 시각, 게재 위치, 오리지널 여부 및 삭제 여부 플래그가 포함됩니다.요청 1,000개당 $8정상
게시글 댓글article_commentsWeChat 공식 계정 기사 하나의 독자 댓글을 호출당 최대 260개까지 수집합니다.요청 1,000개당 $6.76정상
댓글 답글comment_repliesWeChat 공식 계정 기사의 댓글 하나에 달린 답글을 나열합니다.요청 1,000개당 $6.76정상
글 참여 지표article_metricsWeChat 공식 계정 기사 하나의 참여 지표를 확인합니다.요청 1,000개당 $5.56양호 · 상태 99%
WeChat Indexwechat_index키워드가 WeChat에서 얼마나 주목받는지 가늠합니다.요청 1,000개당 $5.56일시적으로 사용 불가

기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.

WeChat Official Accounts 액션별로 어떤 입력을 받나요?

아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.

공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.

액션필수선택전달 방식한도1,000건당응답 필드
article_search

게시글 검색

영문 문서가 제공되는 API로 키워드를 이용해 WeChat 공식 계정 기사를 호출당 최대 400개까지 검색합니다. 각 기사에는 제목, 요약, 커버 이미지, 계정 이름, 게시 시각이 포함됩니다. WeChat 계정이 필요 없습니다. 기사 전체 텍스트는 포함되지 않습니다. 개인 WeChat 로그인 정보를 전달하지 않으므로 category의 팔로우 및 최근 읽음 섹션은 보장되지 않습니다.

keywordcategory, sub_typeSync 응답카탈로그 값: defaultLimit=20, maxLimit=400. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $8id · title · summary · url · cover_image_url · account_name · posted_at · relative_time · kind · platform
article_detail

글 상세 정보

WeChat 공식 계정 기사 하나의 전체 본문을 일반 텍스트와 원본 HTML로 가져옵니다. 작성자, 요약, 커버, 태그, 오리지널 콘텐츠 여부, IP 지역이 포함됩니다. 기사 자체의 mp.weixin.qq.com 링크를 복사해 사용해야 합니다. 검색 결과의 임시 링크는 읽지 못할 수 있습니다. 댓글은 포함되지 않습니다.

url—Sync 응답—요청 1,000개당 $5.56id · title · url · content_text · content_html · author · account_name · account_ghid · digest · cover_image_url · images · hashtags · is_original · posted_at · ip_region · platform
account_search

계정 검색

키워드로 WeChat 공식 계정을 호출당 최대 400개까지 조회합니다. 이름, WeChat ID 별칭, 설명, 아바타, 인증 여부, gh_ 및 __biz 식별자를 가져옵니다. 검색 결과에 일치한다고 해서 법적 신원이나 실제 구독자가 있음이 입증되지는 않습니다.

keyword—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=400. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $16account_id · ghid · name · description · alias · avatar_url · verify_flag · biz · platform
mini_program_search

미니 프로그램 검색

키워드로 WeChat 미니 프로그램을 찾습니다. 각 결과에는 이름, 아이콘, 설명, 사용자 이름, 미니 게임 여부가 포함됩니다. 검색 목록에 표시되는 정보만 제공하며, 프로그램을 실행하거나 내부 데이터에 접근하지 않습니다.

keyword—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=400. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $5.56id · name · description · icon_url · username · is_minigame · platform
search_suggestions

검색어 추천

키워드에 대해 WeChat이 제공하는 자동 완성 추천어와 반환된 추천어 개수를 가져옵니다. 이는 해당 검색어의 관련어일 뿐이며, 검색량, 순위, 과거 트렌드가 아닙니다.

keyword—Sync 응답—요청 1,000개당 $5.56suggestions · count · platform
account_profile

계정 상세 정보

WeChat 공식 계정 프로필을 JSON으로 가져옵니다. 이름, 설명, 아바타, 유형(구독 계정 또는 서비스 계정)이 포함됩니다. 계정의 기사를 해당 계정과 연결하는 account_id와 biz 키도 포함됩니다. 공개된 프로필만 읽습니다. 관리자 백엔드에는 접근하지 않으며, 소유자를 검증하지 않습니다.

account—Sync 응답—요청 1,000개당 $8account_id · name · account_type · description · avatar_url · biz · platform
account_principal

계정 운영 주체

WeChat 공식 계정의 등록 주체를 읽습니다. 회사 또는 운영자 이름, 주체 유형, 인증 상태와 인증일, 등록 국가와 등록일, 권한을 위임받은 대리인을 가져옵니다. 값은 WeChat에 표시되는 경우에만 반환됩니다. 공식 사업자 등록 확인을 대신하지 않으며, 관리자 자격 증명은 노출되지 않습니다.

account—Sync 응답—요청 1,000개당 $5.56account_id · ghid · name · description · company_name · owner_name · customer_type · verify_status · verify_type · verified_at · registered_country · registered_at · is_overseas · last_login_province · authorized_agents · platform
account_articles

계정 게시글

WeChat 공식 계정 하나의 기사 이력을 가져옵니다. 기본 8개, 호출당 최대 160개입니다. 각 기사에는 제목, 링크, 커버, 게시 시각, 게재 위치, 오리지널 여부 및 삭제 여부 플래그가 포함됩니다. 개인 WeChat ID가 아닌 공식 계정의 WeChat ID, gh_ 원시 ID 또는 계정 링크를 전달합니다. 한 번의 호출로 전체 아카이브를 가져오지 못할 수 있습니다.

account—Sync 응답카탈로그 값: defaultLimit=8, maxLimit=160. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $8id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform
account_today_articles

오늘 발행된 계정 게시글

WeChat 공식 계정 하나가 오늘 발행한 기사를 추적하며, 각 기사의 제목, 링크, 커버, 게시 시각, 게재 위치, 오리지널 여부 및 삭제 여부 플래그가 포함됩니다. 당일만 대상으로 하며, 실시간 구독이 아니라 직접 일정을 잡아 호출하는 방식입니다.

account—Sync 응답—요청 1,000개당 $8id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform
article_comments

게시글 댓글

WeChat 공식 계정 기사 하나의 독자 댓글을 호출당 최대 260개까지 수집합니다. 각 댓글에는 텍스트, 작성자, 좋아요, 상단 고정 여부, 답글 수, 표시 위치가 포함됩니다. 계정 페이지가 아닌 기사 자체의 링크를 전달해야 합니다. 모든 댓글이 반환된다고 보장하지 않습니다.

url—Sync 응답카탈로그 값: defaultLimit=13, maxLimit=260. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $6.76id · text · author_name · author_avatar_url · like_count · posted_at · is_top · reply_count · country · province · platform
comment_replies

댓글 답글

WeChat 공식 계정 기사의 댓글 하나에 달린 답글을 나열합니다. 각 답글에는 텍스트, 작성자, 좋아요, 시간, 표시된 국가·성(省)·도시가 포함됩니다. 기사 댓글에서 얻은 comment_id를 같은 기사의 링크와 함께 전달해야 합니다. 이 댓글 외의 답글은 재구성하지 않습니다.

url, comment_idcontent_idSync 응답—요청 1,000개당 $6.76id · text · author_name · author_avatar_url · like_count · posted_at · country · province · city · platform
article_metrics

글 참여 지표

WeChat 공식 계정 기사 하나의 참여 지표를 확인합니다. 조회수, 좋아요, 공유, 저장, 댓글, 그리고 좋아요와 별개인 WeChat 고유의 '보는 중' 수를 가져옵니다. 수치는 호출 시점의 스냅샷이며, 이력이나 계정의 비공개 분석 데이터가 아닙니다.

url—Sync 응답—요청 1,000개당 $5.56read_count · like_count · watching_count · share_count · collect_count · comment_count · platform
wechat_index

WeChat Index

키워드가 WeChat에서 얼마나 주목받는지 가늠합니다. 최신 지수 값과 날짜, 해당 지수의 추이를 보여 주는 시계열 데이터를 제공합니다. 이 값은 지수이며, 검색 횟수나 순 사용자 수가 아니고 EveryInfra 지표도 아닙니다.

keyword—Sync 응답—요청 1,000개당 $5.56keyword · latest_index · latest_date · data_points · trend · platform

WeChat Official Accounts article_search 파라미터는 각각 무엇을 의미하나요?

영문 문서가 제공되는 API로 키워드를 이용해 WeChat 공식 계정 기사를 호출당 최대 400개까지 검색합니다. 각 기사에는 제목, 요약, 커버 이미지, 계정 이름, 게시 시각이 포함됩니다. WeChat 계정이 필요 없습니다. 기사 전체 텍스트는 포함되지 않습니다. 개인 WeChat 로그인 정보를 전달하지 않으므로 category의 팔로우 및 최근 읽음 섹션은 보장되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
WeChat 공식 계정 액션 전반에 사용할 검색어를 지정합니다. 기사 검색(article_search), 계정 검색(account_search), 미니 프로그램 검색(mini_program_search), 검색 자동 추천(search_suggestions), 트렌드 지수(wechat_index)에 사용됩니다. 개인 WeChat 채팅은 검색하지 않습니다.
category선택
article_search 액션에서 카테고리로 기사를 필터링합니다. 허용값은 ALL, LATEST, HOT, FOLLOWED, RECENT_READ입니다. FOLLOWED와 RECENT_READ는 계정 상태에 따라 달라집니다. 개인 WeChat 로그인 세션은 전달되지 않으므로 이 옵션은 동작이 보장되지 않으며, 개인 구독 목록이나 열람 기록을 읽지 않습니다.
sub_type선택
article_search에서 category의 호환용 별칭으로, 동일한 5개 카테고리 값을 받습니다(자동으로 대문자로 변환). category와 sub_type을 모두 지정하면 category가 우선합니다.

WeChat Official Accounts article_detail 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 기사 하나의 전체 본문을 일반 텍스트와 원본 HTML로 가져옵니다. 작성자, 요약, 커버, 태그, 오리지널 콘텐츠 여부, IP 지역이 포함됩니다. 기사 자체의 mp.weixin.qq.com 링크를 복사해 사용해야 합니다. 검색 결과의 임시 링크는 읽지 못할 수 있습니다. 댓글은 포함되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
article_comments, comment_replies, article_metrics, article_detail에 사용할 기사 자체의 mp.weixin.qq.com 링크를 지정합니다. 기사를 열어 링크를 복사하세요(/s/<id> 단축 링크 또는 __biz, mid, idx, sn이 포함된 링크). 검색 결과에서 복사한 임시 링크(signature/timestamp 포함)는 읽지 못할 수 있으며, 읽을 수 없으면 과금 전에 422를 반환합니다. 계정 수준 액션에서는 대상 계정을 확인하기 위한 최하위 우선순위의 대체 입력으로만 이 파라미터를 받습니다.

WeChat Official Accounts account_search 파라미터는 각각 무엇을 의미하나요?

키워드로 WeChat 공식 계정을 호출당 최대 400개까지 조회합니다. 이름, WeChat ID 별칭, 설명, 아바타, 인증 여부, gh_ 및 __biz 식별자를 가져옵니다. 검색 결과에 일치한다고 해서 법적 신원이나 실제 구독자가 있음이 입증되지는 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
WeChat 공식 계정 액션 전반에 사용할 검색어를 지정합니다. 기사 검색(article_search), 계정 검색(account_search), 미니 프로그램 검색(mini_program_search), 검색 자동 추천(search_suggestions), 트렌드 지수(wechat_index)에 사용됩니다. 개인 WeChat 채팅은 검색하지 않습니다.
WeChat: 공식 계정 닉네임, WeChat ID, 원본 ID — WeChat 문서는 nick_name, alias, user_name을 각각 닉네임, 사용자가 설정한 WeChat ID, 원본 ID로 정의하며, alias는 비어 있을 수 있습니다. 이 페이지의 검색 결과에서 name, account_id, ghid는 각각 따로 확인해야 하며 같은 문자열로 취급하면 안 됩니다. · 확인일

WeChat Official Accounts mini_program_search 파라미터는 각각 무엇을 의미하나요?

키워드로 WeChat 미니 프로그램을 찾습니다. 각 결과에는 이름, 아이콘, 설명, 사용자 이름, 미니 게임 여부가 포함됩니다. 검색 목록에 표시되는 정보만 제공하며, 프로그램을 실행하거나 내부 데이터에 접근하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
WeChat 공식 계정 액션 전반에 사용할 검색어를 지정합니다. 기사 검색(article_search), 계정 검색(account_search), 미니 프로그램 검색(mini_program_search), 검색 자동 추천(search_suggestions), 트렌드 지수(wechat_index)에 사용됩니다. 개인 WeChat 채팅은 검색하지 않습니다.

WeChat Official Accounts search_suggestions 파라미터는 각각 무엇을 의미하나요?

키워드에 대해 WeChat이 제공하는 자동 완성 추천어와 반환된 추천어 개수를 가져옵니다. 이는 해당 검색어의 관련어일 뿐이며, 검색량, 순위, 과거 트렌드가 아닙니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
WeChat 공식 계정 액션 전반에 사용할 검색어를 지정합니다. 기사 검색(article_search), 계정 검색(account_search), 미니 프로그램 검색(mini_program_search), 검색 자동 추천(search_suggestions), 트렌드 지수(wechat_index)에 사용됩니다. 개인 WeChat 채팅은 검색하지 않습니다.

WeChat Official Accounts account_profile 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 프로필을 JSON으로 가져옵니다. 이름, 설명, 아바타, 유형(구독 계정 또는 서비스 계정)이 포함됩니다. 계정의 기사를 해당 계정과 연결하는 account_id와 biz 키도 포함됩니다. 공개된 프로필만 읽습니다. 관리자 백엔드에는 접근하지 않으며, 소유자를 검증하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
account필수
대상 WeChat 공식 계정을 WeChat ID, 원본 ID(gh_로 시작) 또는 확인 가능한 계정/기사 URL로 지정합니다. 개인 WeChat ID는 받지 않습니다. account_principal(게시자 프로필 메타데이터), account_articles(과거 게시물 목록), account_today_articles(오늘 게시된 게시물)에서 사용합니다.
WeChat: 계정 유형, 인증 유형, 운영 주체명 — WeChat 공식 문서는 계정 유형, 인증 유형, 운영 주체명을 각각 따로 설명하며, 계정 표시 이름은 운영 주체명과 다릅니다. 이 참고 자료는 용어를 맞추기 위한 것일 뿐 공식 계정 관리 권한을 의미하지 않으며, WeChat의 access_token이나 appid 값을 이 API의 파라미터로 옮겨 쓰지 않습니다. · 확인일

WeChat Official Accounts account_principal 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정의 등록 주체를 읽습니다. 회사 또는 운영자 이름, 주체 유형, 인증 상태와 인증일, 등록 국가와 등록일, 권한을 위임받은 대리인을 가져옵니다. 값은 WeChat에 표시되는 경우에만 반환됩니다. 공식 사업자 등록 확인을 대신하지 않으며, 관리자 자격 증명은 노출되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
account필수
대상 WeChat 공식 계정을 WeChat ID, 원본 ID(gh_로 시작) 또는 확인 가능한 계정/기사 URL로 지정합니다. 개인 WeChat ID는 받지 않습니다. account_principal(게시자 프로필 메타데이터), account_articles(과거 게시물 목록), account_today_articles(오늘 게시된 게시물)에서 사용합니다.
WeChat: 계정 유형, 인증 유형, 운영 주체명 — WeChat 공식 문서는 계정 유형, 인증 유형, 운영 주체명을 각각 따로 설명하며, 계정 표시 이름은 운영 주체명과 다릅니다. 이 참고 자료는 용어를 맞추기 위한 것일 뿐 공식 계정 관리 권한을 의미하지 않으며, WeChat의 access_token이나 appid 값을 이 API의 파라미터로 옮겨 쓰지 않습니다. · 확인일

WeChat Official Accounts account_articles 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 하나의 기사 이력을 가져옵니다. 기본 8개, 호출당 최대 160개입니다. 각 기사에는 제목, 링크, 커버, 게시 시각, 게재 위치, 오리지널 여부 및 삭제 여부 플래그가 포함됩니다. 개인 WeChat ID가 아닌 공식 계정의 WeChat ID, gh_ 원시 ID 또는 계정 링크를 전달합니다. 한 번의 호출로 전체 아카이브를 가져오지 못할 수 있습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
account필수
대상 WeChat 공식 계정을 WeChat ID, 원본 ID(gh_로 시작) 또는 확인 가능한 계정/기사 URL로 지정합니다. 개인 WeChat ID는 받지 않습니다. account_principal(게시자 프로필 메타데이터), account_articles(과거 게시물 목록), account_today_articles(오늘 게시된 게시물)에서 사용합니다.

WeChat Official Accounts account_today_articles 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 하나가 오늘 발행한 기사를 추적하며, 각 기사의 제목, 링크, 커버, 게시 시각, 게재 위치, 오리지널 여부 및 삭제 여부 플래그가 포함됩니다. 당일만 대상으로 하며, 실시간 구독이 아니라 직접 일정을 잡아 호출하는 방식입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
account필수
대상 WeChat 공식 계정을 WeChat ID, 원본 ID(gh_로 시작) 또는 확인 가능한 계정/기사 URL로 지정합니다. 개인 WeChat ID는 받지 않습니다. account_principal(게시자 프로필 메타데이터), account_articles(과거 게시물 목록), account_today_articles(오늘 게시된 게시물)에서 사용합니다.

WeChat Official Accounts article_comments 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 기사 하나의 독자 댓글을 호출당 최대 260개까지 수집합니다. 각 댓글에는 텍스트, 작성자, 좋아요, 상단 고정 여부, 답글 수, 표시 위치가 포함됩니다. 계정 페이지가 아닌 기사 자체의 링크를 전달해야 합니다. 모든 댓글이 반환된다고 보장하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
article_comments, comment_replies, article_metrics, article_detail에 사용할 기사 자체의 mp.weixin.qq.com 링크를 지정합니다. 기사를 열어 링크를 복사하세요(/s/<id> 단축 링크 또는 __biz, mid, idx, sn이 포함된 링크). 검색 결과에서 복사한 임시 링크(signature/timestamp 포함)는 읽지 못할 수 있으며, 읽을 수 없으면 과금 전에 422를 반환합니다. 계정 수준 액션에서는 대상 계정을 확인하기 위한 최하위 우선순위의 대체 입력으로만 이 파라미터를 받습니다.
WeChat 공식 계정: 아티클 댓글과 선정 댓글의 구분 — WeChat 댓글 문서는 아티클, 댓글 ID, 추천 여부 플래그, 답글 상세 정보를 구분합니다. 공식 승인 인터페이스의 백엔드에서 확인할 수 있는 댓글 범위는 이 엔드포인트의 조회 범위와 같지 않으며, `is_top`을 공식 comment_type의 추천 플래그로 바로 간주할 수 없습니다. · 확인일

WeChat Official Accounts comment_replies 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 기사의 댓글 하나에 달린 답글을 나열합니다. 각 답글에는 텍스트, 작성자, 좋아요, 시간, 표시된 국가·성(省)·도시가 포함됩니다. 기사 댓글에서 얻은 comment_id를 같은 기사의 링크와 함께 전달해야 합니다. 이 댓글 외의 답글은 재구성하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
article_comments, comment_replies, article_metrics, article_detail에 사용할 기사 자체의 mp.weixin.qq.com 링크를 지정합니다. 기사를 열어 링크를 복사하세요(/s/<id> 단축 링크 또는 __biz, mid, idx, sn이 포함된 링크). 검색 결과에서 복사한 임시 링크(signature/timestamp 포함)는 읽지 못할 수 있으며, 읽을 수 없으면 과금 전에 422를 반환합니다. 계정 수준 액션에서는 대상 계정을 확인하기 위한 최하위 우선순위의 대체 입력으로만 이 파라미터를 받습니다.
comment_id필수
comment_replies의 대상 댓글 ID를 지정합니다. 같은 기사의 article_comments 응답에서 이 값을 가져오세요. 해당 기사 URL과 함께 전달해야 하며, 기사 ID가 아닙니다.
WeChat 공식 계정: 기존 답글 조회와 댓글 관리 작업 — WeChat은 댓글 보기, 답글 작성, 답글 삭제, 추천 댓글 관리를 별도의 작업으로 구분합니다. 여기의 `comment_replies` 엔드포인트는 기존 답글만 읽으며, 이름에 replies가 들어 있다고 해서 댓글을 작성, 삭제, 관리하는 기능을 제공하지는 않습니다. · 확인일
content_id선택
comment_replies 액션에서 comment_id의 호환용 별칭입니다. 둘 다 지정하면 comment_id보다 우선순위가 낮습니다.

WeChat Official Accounts article_metrics 파라미터는 각각 무엇을 의미하나요?

WeChat 공식 계정 기사 하나의 참여 지표를 확인합니다. 조회수, 좋아요, 공유, 저장, 댓글, 그리고 좋아요와 별개인 WeChat 고유의 '보는 중' 수를 가져옵니다. 수치는 호출 시점의 스냅샷이며, 이력이나 계정의 비공개 분석 데이터가 아닙니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
article_comments, comment_replies, article_metrics, article_detail에 사용할 기사 자체의 mp.weixin.qq.com 링크를 지정합니다. 기사를 열어 링크를 복사하세요(/s/<id> 단축 링크 또는 __biz, mid, idx, sn이 포함된 링크). 검색 결과에서 복사한 임시 링크(signature/timestamp 포함)는 읽지 못할 수 있으며, 읽을 수 없으면 과금 전에 422를 반환합니다. 계정 수준 액션에서는 대상 계정을 확인하기 위한 최하위 우선순위의 대체 입력으로만 이 파라미터를 받습니다.

WeChat Official Accounts wechat_index 파라미터는 각각 무엇을 의미하나요?

키워드가 WeChat에서 얼마나 주목받는지 가늠합니다. 최신 지수 값과 날짜, 해당 지수의 추이를 보여 주는 시계열 데이터를 제공합니다. 이 값은 지수이며, 검색 횟수나 순 사용자 수가 아니고 EveryInfra 지표도 아닙니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
WeChat 공식 계정 액션 전반에 사용할 검색어를 지정합니다. 기사 검색(article_search), 계정 검색(account_search), 미니 프로그램 검색(mini_program_search), 검색 자동 추천(search_suggestions), 트렌드 지수(wechat_index)에 사용됩니다. 개인 WeChat 채팅은 검색하지 않습니다.

WeChat Official Accounts API 사용 방법

  1. 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
  2. 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
  3. 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
  4. 04애플리케이션에 필요한 응답 필드를 저장합니다.
wechat_oa_article_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"wechat_oa","action":"article_search","params":{"keyword":"<keyword>"}}'

WeChat Official Accounts 가이드

이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.

Build

멀티 플랫폼 평판 모니터링 설계도: 부정 여론의 변화를 평가하기 전에 범위부터 정의하기

대상 목록, 댓글 식별자, 증분 커서에서 출발해 추적 가능한 평판 모니터링 워크플로를 설계하고, 오프라인 샘플로 중복 제거와 수집 누락을 보여 주며, 사람의 검토 단계를 유지합니다.

글 읽기
Build

통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지

platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.

글 읽기

WeChat Official Accounts API 자주 묻는 질문

WeChat Official Accounts API로 무엇을 가져올 수 있나요?

platform을 wechat_oa 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 게시글 검색, 글 상세 정보, 계정 검색, 미니 프로그램 검색, 검색어 추천 및 more입니다. 각 액션 이름은 서로 다른 WeChat Official Accounts 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.

WeChat Official Accounts에 공식 API가 있나요?

WeChat Official Account API를 사용하면 운영자는 해당 계정의 자격 증명으로 자신의 계정(임시 저장 글, 게시, 메뉴, 팔로워, 자신이 작성한 글의 댓글, 분석)을 관리할 수 있습니다. 공식 API 레퍼런스에는 다른 계정이 게시한 글을 읽는 엔드포인트가 없습니다.

공식 출처: WeChat Official Accounts API reference · 확인일

WeChat Official Accounts 개발자 계정이나 API 키가 필요한가요?

아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. WeChat Official Accounts 개발자 앱을 등록하거나, WeChat Official Accounts API 접근을 신청하거나, WeChat Official Accounts 계정으로 로그인할 필요가 없으며, 액션은 공개된 WeChat Official Accounts 데이터만 반환합니다.

WeChat Official Accounts API 요금은 요청 1,000건당 얼마인가요?

액션에 따라 요청 1,000개당 $5.56부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.

WeChat Official Accounts article_search 요청에는 어떤 입력이 필요한가요?

WeChat 공식 계정 액션 전반에 사용할 검색어를 지정합니다. 기사 검색(article_search), 계정 검색(account_search), 미니 프로그램 검색(mini_program_search), 검색 자동 추천(search_suggestions), 트렌드 지수(wechat_index)에 사용됩니다. 개인 WeChat 채팅은 검색하지 않습니다. params 안의 keyword 필드로 전달하세요.

WeChat Official Accounts article_search 액션은 어떤 필드를 반환하나요?

선언된 스키마에 포함된 필드는 title, summary, cover_image_url 및 account_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.

모든 WeChat Official Accounts 액션이 즉시 결과를 반환하나요?

비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.