WeChat Official Accounts 계정 게시글 API
피크 시간대에는 일시적으로 사용할 수 없을 수 있음
이 기능은 피크 시간대에 일시적으로 사용할 수 없을 수 있습니다. 잠시 후 다시 시도하세요. 실패한 호출에는 과금하지 않습니다.
API 상태
- 24시간 상태
- 83%
- 24시간 평균 소요 시간
- 11.07 s
- 양호 / 정상
- 사용 가능
- 제한적
- 대부분 작동 중단
최근 24시간
최근 30일
WeChat 공식 계정 하나의 기사 이력을 가져옵니다. 기본 8개, 호출당 최대 160개입니다. 각 기사에는 제목, 링크, 커버, 게시 시각, 게재 위치, 오리지널 여부 및 삭제 여부 플래그가 포함됩니다. 개인 WeChat ID가 아닌 공식 계정의 WeChat ID, gh_ 원시 ID 또는 계정 링크를 전달합니다. 한 번의 호출로 전체 아카이브를 가져오지 못할 수 있습니다.
WeChat 공식 계정 글 목록 기능은 account로 지정한 계정이 게시한 글을 나열합니다. 각 행에는 제목, 링크, 커버 이미지, 게시 시간, 위치, 오리지널 표시 여부, 삭제 여부가 담깁니다. 계정이 어떤 글을 써 왔고 얼마나 자주 게시하는지 파악할 때 사용하며, 계정 평가, 경쟁사 콘텐츠 검토, 업계 글 라이브러리 구축에 활용할 수 있습니다.
account에는 WeChat ID, gh_로 시작하는 원시 ID, 또는 계정을 식별할 수 있는 계정 링크나 글 링크를 넣을 수 있으며, 개인 WeChat ID는 사용할 수 없습니다. position은 발송 묶음 안에서 글의 순서로, 가장 낮은 값이 대표 글입니다. is_deleted는 삭제된 글을, is_original은 오리지널 저작을 표방하는 글을 표시합니다. account_ghid는 WeChat 내에서 계정의 고유 ID이므로 중복 제거 키로 적합합니다.
요금은 요청 1,000개당 $8(호출당 $0.008)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.
AI 프롬프트
EveryInfra WeChat Official Accounts 계정 게시글 엔드포인트(wechat_oa/account_articles)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.
엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 wechat_oa, action은 account_articles로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
- account: 대상 WeChat 공식 계정을 WeChat ID, 원본 ID(gh_로 시작) 또는 확인 가능한 계정/기사 URL로 지정합니다. 개인 WeChat ID는 받지 않습니다. account_principal(게시자 프로필 메타데이터), account_articles(과거 게시물 목록), account_today_articles(오늘 게시된 게시물)에서 사용합니다.
- 선택 파라미터:
- limit: 이 호출에서 반환할 최대 행 수로, 1~160 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다. (기본값: 8)
- 레코드 목록을 반환합니다. 각 레코드의 주요 필드: id, title, url, cover_image_url (기사 커버 이미지 URL), posted_at, position (한 번의 발송 내 기사 위치: 숫자가 가장 작은 기사가 메인 기사입니다), is_original (기사에 자체 창작 콘텐츠임을 밝히는 선언이 있는지 여부), is_deleted (콘텐츠 삭제 여부), account_name (기사를 게시한 공식 계정 이름), account_id (공식 계정 ID(WeChat ID)), account_ghid (gh_로 시작하는 계정의 원본 ID로, WeChat 내에서 고유합니다).
- 요청 본문 예시:
{
"platform": "wechat_oa",
"action": "account_articles",
"params": {
"account": "36氪"
}
}
- 요금: 요청 1,000개당 $8. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.
코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.요청 파라미터
| 이름 | 위치 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|---|
Authorization | header | string | 예 | - | Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요. |
platform | body | string | 예 | wechat_oa | 플랫폼 식별자이며 고정값입니다. |
action | body | string | 예 | account_articles | 기능 식별자이며 고정값입니다. |
account | body.params | string | 예 | - | 대상 WeChat 공식 계정을 WeChat ID, 원본 ID(gh_로 시작) 또는 확인 가능한 계정/기사 URL로 지정합니다. 개인 WeChat ID는 받지 않습니다. account_principal(게시자 프로필 메타데이터), account_articles(과거 게시물 목록), account_today_articles(오늘 게시된 게시물)에서 사용합니다. |
limit | body.params | integer (1–160) | 아니요 | 8 | 이 호출에서 반환할 최대 행 수로, 1~160 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다. |
코드 샘플
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "wechat_oa",
"action": "account_articles",
"params": {
"account": "36氪"
}
}'OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.
응답 예시
October 24, 2026 at 18:28(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다(목록은 처음 2개만 표시). id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.
{
"id": "req_…",
"platform": "wechat_oa",
"action": "account_articles",
"results": [
{
"id": 2248907014,
"title": "新天坑专业来了!",
"url": "http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=1&sn=53f65801e362eac1102cfd9ac0958ddd&chksm=e83826ef9b9138c6ac8c1e4b88daa14c0941bd82c199db5406890e2ccf5d02f76f320b805553&scene=126&sessionid=0#rd",
"cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/o02wSnKAPeGiaFn4ZHxq44OgF3EvsV427DibBQJ3Wm0d1Jp1al1aMxXGGT4DJibn5KRr8oiajiadOaNA1tK2Mic69MEHcZnAuwPKfyNCXM7zb2icT0/640?wxtype=jpeg&wxfrom=25",
"posted_at": "2026-10-24T13:30:00+00:00",
"position": 1,
"account_ghid": "gh_240fbf8b33e4",
"platform": "wechat_oa"
},
{
"id": 2248907014,
"title": "全脂中产疯抢「蛋白糕」:噎得干瞪眼也不能掉肌肉",
"url": "http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=2&sn=7742abe42aa2ecc2da11d0020e7d968f&chksm=e8a0eeb36a2ae07e805bb65471cd6c5726d303af90b895df7b9624215dacb7bb72ea8b1fb776&scene=126&sessionid=0#rd",
"cover_image_url": "https://mmbiz.qpic.cn/mmbiz_jpg/o02wSnKAPeGOU4Kj24AlXJ6tReJdcGBRu5HkBKicfQDxmkUPUgw1U2l3icNibSe0k2nbKqXmWmIe4ibatjOm0sxFahFotcDNia495enyZrOVbicVQ/300?wxtype=jpeg&wxfrom=25",
"posted_at": "2026-10-24T13:30:00+00:00",
"position": 2,
"account_ghid": "gh_240fbf8b33e4",
"platform": "wechat_oa"
}
],
"count": 36,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}응답 필드
비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.
| 필드 | 의미 |
|---|---|
id | 플랫폼에서 레코드의 고유 ID입니다. 한 플랫폼 안에서만 고유하며, 플랫폼이 다르면 ID가 중복될 수 있습니다. |
title | 제목입니다. 플랫폼에 제목이 없으면 null입니다(예: 텍스트 전용 게시물). |
url | 플랫폼에서 해당 레코드로 연결되는 링크입니다. |
cover_image_url | 기사 커버 이미지 URL. |
posted_at | 게시 시각으로, ISO 8601 UTC 형식입니다(예: 2026-08-07T12:34:56+00:00). 플랫폼에서 받은 비표준 문자열은 그대로 전달되므로 방어적으로 파싱하세요. null이면 플랫폼이 공개하지 않은 것입니다. |
position | 한 번의 발송 내 기사 위치: 숫자가 가장 작은 기사가 메인 기사입니다. 조회 수나 인기 순위가 아닙니다. |
is_original | 기사에 자체 창작 콘텐츠임을 밝히는 선언이 있는지 여부. |
is_deleted | 콘텐츠 삭제 여부. |
account_name | 기사를 게시한 공식 계정 이름. |
account_id | 공식 계정 ID(WeChat ID). |
account_ghid | gh_로 시작하는 계정의 원본 ID로, WeChat 내에서 고유합니다. |
platform | 출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok). |
FAQ
account에는 무엇을 전달할 수 있나요?
WeChat ID, gh_로 시작하는 원시 ID, 또는 계정을 식별할 수 있는 계정 링크나 글 링크입니다. 개인 WeChat ID는 사용할 수 없습니다. 계정 이름만 알고 있다면 먼저 WeChat 계정 검색 기능으로 ID를 찾으십시오.
오리지널 글이나 삭제된 글은 어떻게 알아보나요?
is_original은 해당 글이 오리지널 저작을 표방하면 true입니다. 콘텐츠가 삭제되었으면 is_deleted가 true이며, 이런 링크는 더 이상 열리지 않을 수 있으므로 해당 글은 따로 집계하십시오.
계정 중복은 어떻게 제거하나요?
account_ghid를 사용하십시오. 이는 gh_로 시작하는 원시 ID로, WeChat 내에서 고유합니다. 계정 이름은 시간이 지나면서 바뀔 수 있으므로 저장하는 글의 키로는 적합하지 않습니다.
오류 및 과금
- 401
- 키가 없거나 유효하지 않습니다.
- 402
- 잔액이 부족합니다. 먼저 충전하세요.
- 422
- 파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
- 429
- 분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
- 503
- 처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
- 200 빈 결과
- 데이터가 없습니다. 과금되지 않습니다.