API WeChat Channels Post dell'utente
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Quasi del tutto inattivo
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Elenca gli ultimi 15 video di un account WeChat Channels tramite il suo username (l'ID v2_...@finder). Ogni video ha ID, titolo, descrizione, ora di pubblicazione, numero di like, salvataggi, condivisioni e commenti, durata, dimensioni del fotogramma, copertina e un link al file video a tempo limitato con la chiave necessaria per decifrarlo. L'ID dell'account non è il nickname.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su wechat_channels e action impostato su user_posts. Prezzo $46 per 1.000 richieste ($0.046 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.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint WeChat Channels Post dell'utente di EveryInfra (wechat_channels/user_posts).
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_channels e action su user_posts, e inserisci i parametri in params.
- Parametri obbligatori:
- username: L'ID account WeChat Channels per user_posts, nel formato v2_...@finder, preso dall'author_username di una riga di user_posts o video, oppure l'ID del canale che inizia con sph mostrato nella pagina del canale, ad es.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero pari o superiore a 1. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe.
- Restituisce un elenco di record. Campi principali di ogni record: id (ID del video (una stringa di cifre) nel…), author_username (ID dell'account WeChat Channels dell'au…), author_name, title, description, posted_at, like_count (Mi piace: quelli del video nelle righe…), collect_count (Numero di volte in cui il video è stato…), share_count, comment_count, duration_sec (Durata del video in secondi), duration_seconds; 17 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_channels.
- Esempio di corpo della richiesta:
{
"platform": "wechat_channels",
"action": "user_posts",
"params": {
"username": "v2_060000231003b20faec8c7ea8d11c3d4c907e83db0775f87c9449acd6a89298e462485cc23a8@finder"
}
}
- Prezzo: $46 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_channels | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | user_posts | Identificativo della funzionalità, valore fisso. |
username | body.params | string | Sì | - | L'ID account WeChat Channels per user_posts, nel formato v2_...@finder, preso dall'author_username di una riga di user_posts o video, oppure l'ID del canale che inizia con sph mostrato nella pagina del canale, ad es. sphi9BjV8GK0Zsl. Non è il nickname, e le righe di ricerca non lo contengono. Altri formati vengono rifiutati prima di qualsiasi addebito. |
limit | body.params | integer (1–) | No | - | Numero massimo di righe da restituire in questa chiamata: un intero pari o superiore a 1. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. |
Esempi di codice
#bash
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_channels",
"action": "user_posts",
"params": {
"username": "v2_060000231003b20faec8c7ea8d11c3d4c907e83db0775f87c9449acd6a89298e462485cc23a8@finder"
}
}'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
#Acquisita il November 7, 2026 at 14:47 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "platform": "wechat_channels", "action": "user_posts", "results": [ { "id": "•••", "author_username": "v2_060000231003b20faec8c7ea8d11c3d4c907e83db0775f87c9449acd6a89298e462485cc23a8@finder", "author_name": "回•••儿", "title": "被降将暗算的“万夫之雄”", "description": "回族故事（一百零三）被降将暗算的“万夫之雄” 胡大海（?-1362）——一个不识字却懂大义的回族名将，一个用宽厚待人却死于背叛的悲剧英雄。#回族 #故事 #名将 #胡大海", "posted_at": "2026-11-06T08:26:38+00:00", "like_count": 13, "collect_count": 29, "share_count": 7, "comment_count": 7, "duration_sec": 106, "video_width": 1080, "video_height": 1920, "cover_url": "https://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=KGDRibp2wkicIWrOjAOlHhPYKT3aHtj1esQgb1g5IibWQFrTRSXCaqN8a2rrMklqTWfrLRBTeicmv3ArLmXtrlxbPQ&hy=SZ&idx=1&m=&scene=2&uzid=1&picformat=200&wxampicformat=503&token=AxricY7RBHdXmNH8wKVf8EKlthOnAToObQ4xRAlLQwkGHibrant9Po3ic5vsZbTt…", "video_url": "http://wxapp.tc.qq.com/251/20302/stodownload?encfilekey=rgjNqbibdAo1Imz2qecDBSu1IIRfZibleJjjUfrgLEVD4v5d3dwxrJpIz5d1mnPGDDt88ib02nhaSts4hQGGA7QJw&bizid=1023&dotrans=0&hy=SH&idx=1&m=&uzid=7a256&token=AxricY7RBHdWl6csXaYPFhVS0Vrb2FOBYJ2icQY8702SyiccNpc2SLPO0CCzdrE4adQwV9BjDglFTbTlX…", "video_decode_key": "30417386", "platform": "wechat_channels", "duration_seconds": 106 }, { "id": "•••", "author_username": "v2_060000231003b20faec8c7ea8d11c3d4c907e83db0775f87c9449acd6a89298e462485cc23a8@finder", "author_name": "回•••儿", "title": "岛姓大揭秘 历史渊源全知道", "description": "回族姓氏（五十）下 岛姓大揭秘！历史渊源全知道 一个“岛”字，在回族脉络里，是明初大移民中太原回民十大姓之一的家族记忆，是河南淮阳文兴集村那六十多口岛姓人家的口耳相传；在华夏脉络中，是先秦“岛人”的遥远回响，是避居岛屿的生存智慧，也是傣族尊称演变为汉姓的语言化石。#回族 #姓氏 #故事 #姓氏起源", "posted_at": "2026-11-04T08:43:14+00:00", "like_count": 13, "collect_count": 22, "share_count": 4, "comment_count": 6, "duration_sec": 133, "video_width": 1080, "video_height": 1920, "cover_url": "https://wxapp.tc.qq.com/251/20304/stodownload?encfilekey=KGDRibp2wkicLZ9ozsqiagRKIEzjeTLibwfduJo47zwg84bcicvENTbnZsicnj7lBKk8aS1ICgQYO0OVHvG1CenlibA5g&hy=SZ&idx=1&m=&scene=2&uzid=1&picformat=200&wxampicformat=503&token=ic1n0xDG6aw8rOpSWtpOfY4wg0BbiauR4EvnyOV56DdfQhWpiaOK9Fb2wllKU…", "video_url": "http://wxapp.tc.qq.com/251/20302/stodownload?encfilekey=rgjNqbibdAo3AicbpbiaVdpY2Bse3IMn04giagia1j6YmgL3HROnLFUSv5OTJFxyKFTYXSxwQwBkffgbIaKzg8C7NxA&bizid=1023&dotrans=0&hy=SH&idx=1&m=&uzid=7a256&token=2lt8WBSnjTnMroEXicnxze37zjbpOeqshuPYSSt92tKbDWR7nwmaaJKkDZ77QBeXjeKLMkY4HxlALTb…", "video_decode_key": "•••", "platform": "wechat_channels", "duration_seconds": 133 } ], "count": 15, "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 del video (una stringa di cifre) nelle righe user_posts e video; passalo come object_id a video o comments. Nelle righe comments, l'ID del commento. |
author_username | ID dell'account WeChat Channels dell'autore, v2_...@finder (user_posts / video); passalo come username a user_posts. |
author_name | Nome visualizzato dell'autore. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
description | Riepilogo o descrizione, di solito più breve di text. |
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. |
like_count | Mi piace: quelli del video nelle righe search, user_posts e video, quelli del commento nelle righe comments. In user_posts e video, oltre 10.000 i Mi piace sono precisi solo alle centinaia e terminano sempre con 02 (20002 corrisponde a circa 20.000); da 100.000 in su il valore è sempre 100002 (l'app mostra solo 100k+). |
collect_count | Numero di volte in cui il video è stato salvato (user_posts / video). Oltre 10.000 è preciso solo alle centinaia e termina sempre con 02 (14402 corrisponde a circa 14.400); da 100.000 in su è sempre 100002 (l'app mostra solo 100k+). |
share_count | Condivisioni. null significa non rese note, non 0. |
comment_count | Commenti. null significa non resi noti, non 0. |
duration_sec | Durata del video in secondi. |
duration_seconds | Durata in secondi. null per i contenuti che non sono video o audio. |
video_width | Larghezza del fotogramma del video in pixel. |
video_height | Altezza del fotogramma del video in pixel. |
cover_url | URL dell'immagine di copertina (firmato, con scadenza). |
video_url | URL del file video (user_posts / video; firmato, valido per circa 24 ore). La parte iniziale del file è cifrata, quindi un file scaricato direttamente non si riproduce finché non lo decifri con video_decode_key. |
video_decode_key | Chiave per decifrare la parte iniziale cifrata del file video (user_posts / video); è associata a quel video_url. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
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.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- WeChat Open Docs: l'ID dell'account Channels (finderUserName) ↗
Secondo la documentazione per sviluppatori di WeChat, finderUserName è l'ID dell'account Channels, mostrato all'autore nella home page dell'assistente di Channels. La fonte conferma solo che un account Channels ha un ID distinto dal nickname; lo username di questa API è l'ID account v2_...@finder ricavato dalle righe user_posts o video e non è intercambiabile con l'ID mostrato in quella home page.
Verificato il 2026-10-25