API Reddit Subreddit info
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
Ultime 24 ore
Ultimi 30 giorni
Ottieni il profilo di un subreddit come singolo oggetto. subreddit è obbligatorio: il nome di una community (python o r/python) o un link alla community, uno per chiamata. L'oggetto contiene community (il nome senza r/), community_id (inizia con t5_), url, title, description, member_count (alcune richieste tornano senza), weekly_visitor_count e weekly_contribution_count (i visitatori e i contributi settimanali mostrati nella pagina della community), created_at, community_type (public, restricted o private), icon_url e banner_url. Una community che non esiste, è privata o è stata bannata restituisce un risultato vuoto. Le regole e i link del menu si trovano in subreddit_rules.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su reddit e action impostato su subreddit_info. Prezzo $0.79 per 1.000 richieste ($0.000792 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 Reddit Subreddit info di EveryInfra (reddit/subreddit_info).
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 reddit e action su subreddit_info, e inserisci i parametri in params.
- Parametri obbligatori:
- subreddit: The community to look up: a name (python or r/python) or a community link. One community per call.
- Restituisce un oggetto. Campi principali: community, community_id (Reddit's ID for the community, starting…), url, title, description, member_count (How many members the community has (sub…), weekly_visitor_count (Weekly visitors to the community as Red…), weekly_contribution_count (Weekly contributions to the community,…), created_at, community_type (Type of the community: public, restrict…), icon_url (Image URL of the icon: the community ic…), banner_url (Image URL of the banner on the communit…).
- Esempio di corpo della richiesta:
{
"platform": "reddit",
"action": "subreddit_info",
"params": {
"subreddit": "python"
}
}
- Prezzo: $0.79 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ì | reddit | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | subreddit_info | Identificativo della funzionalità, valore fisso. |
subreddit | body.params | string | Sì | - | The community to look up: a name (python or r/python) or a community link. One community per call. |
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": "reddit",
"action": "subreddit_info",
"params": {
"subreddit": "python"
}
}'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": "reddit", "action": "subreddit_info", "results": { "community": …, "community_id": …, "url": …, "title": …, "description": …, "member_count": …, "weekly_visitor_count": …, "weekly_contribution_count": …, "created_at": …, "community_type": …, "icon_url": …, "banner_url": …, "platform": … }, "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 |
|---|---|
community | Mantiene il significato attribuito dalla piattaforma |
community_id | Reddit's ID for the community, starting with t5_ (subreddit_info, subreddit_rules, search_suggest, user_subreddits, explore, topic_subreddits). |
url | Link al record sulla piattaforma. |
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. |
member_count | How many members the community has (subreddit_info, user_subreddits). A few requests come back without it. |
weekly_visitor_count | Weekly visitors to the community as Reddit shows it (subreddit_info, explore, topic_subreddits). In search_suggest it is the rounded figure from the dropdown, so 93K is recorded as 93000, and not every row has it. |
weekly_contribution_count | Weekly contributions to the community, as shown on its page (subreddit_info). |
created_at | Data e ora di creazione, nello stesso formato di posted_at. |
community_type | Type of the community: public, restricted or private (subreddit_info). |
icon_url | Image URL of the icon: the community icon (subreddit_info, subreddit_rules, search_suggest, user_subreddits, explore, topic_subreddits) or the achievement icon (user_trophies). |
banner_url | Image URL of the banner on the community page (subreddit_info, subreddit_rules) or on the user's profile (profile). |
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.