API WeChat Official Accounts Articoli dell'account
Potrebbe essere temporaneamente non disponibile nei momenti di picco
Questa funzionalità potrebbe essere temporaneamente non disponibile nei momenti di picco; riprova più tardi. Le chiamate non riuscite non vengono addebitate.
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 98%
- Tempo medio nelle ultime 24 ore
- 5.02 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Estrai lo storico degli articoli di un WeChat Official Account, 8 di default e fino a 160 per chiamata. Ogni articolo ha titolo, link, copertina, ora di pubblicazione, posizione e flag originale o eliminato. Passa un WeChat ID, un ID raw gh_ o il link dell'account, non un WeChat ID personale. Un batch potrebbe non coprire l'intero archivio.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su wechat_oa e action impostato su account_articles. Prezzo $8 per 1.000 richieste ($0.008 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
La funzionalità WeChat Official Account articles elenca gli articoli pubblicati da un account, indicato con account. Ogni riga contiene titolo, link, immagine di copertina, data di pubblicazione, posizione e se l'articolo è contrassegnato come originale o è stato eliminato. Usala per vedere di cosa scrive un account e con che frequenza pubblica, per valutare account, analizzare i contenuti di un concorrente o creare un archivio di articoli di settore.
account accetta un ID WeChat, l'ID grezzo che inizia con gh_ oppure un link a un account o a un articolo che identifichi l'account; un ID WeChat personale non funziona. position è la posizione dell'articolo nel suo invio, dove il valore più basso indica l'articolo principale; is_deleted contrassegna gli articoli rimossi e is_original quelli che dichiarano di essere originali. account_ghid è l'ID univoco dell'account all'interno di WeChat, ed è quindi la chiave giusta per la deduplicazione.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint WeChat Official Accounts Articoli dell'account di EveryInfra (wechat_oa/account_articles).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su wechat_oa e action su account_articles, e inserisci i parametri in params.
- Parametri obbligatori:
- account: Identifica l'Official Account WeChat di destinazione tramite il suo WeChat ID, l'ID raw (che inizia con gh_) o un URL di account o articolo risolvibile. Non accetta WeChat ID personali.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 160. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 8)
- Restituisce un elenco di record. Campi principali di ogni record: id, title, url, cover_image_url (URL dell'immagine di copertina dell'art…), posted_at, position (Posizione dell'articolo all'interno di…), is_original (Indica se l'articolo riporta una dichia…), is_deleted (Indica se il contenuto è stato eliminat…), account_name (Nome dell'Official Account che ha pubbl…), account_id (ID dell'Official Account (il suo WeChat…), account_ghid (ID grezzo dell'account che inizia con g…).
- Esempio di corpo della richiesta:
{
"platform": "wechat_oa",
"action": "account_articles",
"params": {
"account": "36氪"
}
}
- Prezzo: $8 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | wechat_oa | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | account_articles | Identificativo della funzionalità, valore fisso. |
account | body.params | string | Sì | - | Identifica l'Official Account WeChat di destinazione tramite il suo WeChat ID, l'ID raw (che inizia con gh_) o un URL di account o articolo risolvibile. Non accetta WeChat ID personali. Usato da account_principal (per i metadati del profilo dell'editore), account_articles (per l'elenco storico dei post) e account_today_articles (per i post pubblicati oggi). |
limit | body.params | integer (1–160) | No | 8 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 160. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#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氪"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "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": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
url | Link al record sulla piattaforma. |
cover_image_url | URL dell'immagine di copertina dell'articolo. |
posted_at | Data e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note. |
position | Posizione dell'articolo all'interno di un singolo invio: il numero più basso indica l'articolo principale. Non è una classifica per letture o popolarità. |
is_original | Indica se l'articolo riporta una dichiarazione di contenuto originale. |
is_deleted | Indica se il contenuto è stato eliminato. |
account_name | Nome dell'Official Account che ha pubblicato l'articolo. |
account_id | ID dell'Official Account (il suo WeChat ID). |
account_ghid | ID grezzo dell'account che inizia con gh_, univoco all'interno di WeChat. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Cosa posso passare come account?
#Un ID WeChat, l'ID grezzo che inizia con gh_ oppure un link a un account o a un articolo che identifichi l'account. Gli ID WeChat personali non funzionano. Se conosci solo il nome dell'account, trova prima il suo ID con la funzionalità WeChat Account search.
Come riconosco gli articoli originali o eliminati?
#is_original è true quando l'articolo dichiara di essere originale. is_deleted è true quando il contenuto è stato rimosso; questi link potrebbero non aprirsi più, quindi conta questi articoli separatamente.
Come deduplico gli account?
#Usa account_ghid, l'ID grezzo che inizia con gh_, univoco all'interno di WeChat. I nomi degli account possono cambiare nel tempo, quindi non sono chiavi affidabili per gli articoli che memorizzi.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.