API para Reddit

API para Reddit: Busca no subreddit

Busque posts dentro de um único subreddit por consulta, ordenação e período. Pagine com o campo cursor.

POST/v1/run/reddit.subreddit_search
Disponibilidade
99,45%
30d · 6.014 chamadas
Requisições
6.031
30d · semanal, últimas 12 sem.
Resposta
1,2s
mediana · 30d

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `isArchived` ou `selftext`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um post que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "found": true,
  "data": {
    "posts": [
      {
        "id": "t3_1ghi890",
        "title": "Quietest silent switches you have tried?",
        "author": "lurkmoar",
        "score": 612,
        "numComments": 144,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1ghi890/",
        "permalink": "/r/MechanicalKeyboards/comments/1ghi890/",
        "createdUtc": 1718160000,
        "subreddit": "MechanicalKeyboards",
        "nsfw": false
      }
    ],
    "nextCursor": "t3_1ghi890"
  }
}
Interface da resposta
interface RedditSubredditSearchResponse {
  data: {
    nextCursor: string | null;
    posts: {
      author: string;
      authorId?: string;
      createdUtc: number;
      id: string;
      isArchived?: boolean;
      isLocked?: boolean;
      nsfw: boolean;
      numComments: number;
      permalink: string;
      score: number;
      selftext?: string;
      subreddit: string;
      title: string;
      url: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/reddit.subreddit_search
curl -X POST https://api.getanyapi.com/v1/run/reddit.subreddit_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subreddit":"MechanicalKeyboards","query":"silent switches"}'
CampoTipoValor de exemplo
Corpo da requisição
subredditstring"MechanicalKeyboards"Nome do subreddit sem o prefixo r/ (ex.: 'Fitness').
cursorstringToken de paginação opcional de uma resposta anterior.
querystring"silent switches"Consulta de busca opcional para encontrar posts (ex.: 'push ups').
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `isArchived` ou `selftext`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um post que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.
sortenumOrdenação opcional: relevance, hot, top, new, comments.
timeframeenumFiltro de tempo opcional: all, year, month, week, day, hour.
Resposta
foundbooleantrue
dataobject
data.postsarray
data.posts[].idstring"t3_1ghi890"
data.posts[].titlestring"Quietest silent switches you have tried?"
data.posts[].authorstring"lurkmoar"
data.posts[].scorenumber612
data.posts[].numCommentsnumber144
data.posts[].urlstring"https://www.reddit.com/r/MechanicalKeyboards/comments/1ghi890/"
data.posts[].permalinkstring"/r/MechanicalKeyboards/comments/1ghi890/"
data.posts[].createdUtcnumber1718160000
data.posts[].subredditstring"MechanicalKeyboards"
data.posts[].nsfwbooleanfalse
data.nextCursorstring"t3_1ghi890"
Preço
Preço por requisiçãoUSDUS$ 0,00038
Preço /mil req.USDUS$ 0,38

Dúvidas frequentes

Sobre o endpoint Busca no subreddit da API para Reddit

O endpoint Busca no subreddit da AnyAPI para Reddit retorna dados de Reddit em JSON normalizado com uma chamada POST para /v1/run/reddit.subreddit_search. Busque posts dentro de um único subreddit por consulta, ordenação e período. Pagine com o campo cursor. A AnyAPI distribui cada requisição entre 5 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,38 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,5% das chamadas ao endpoint Busca no subreddit da API para Reddit feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,2 segundos, em 6.014 chamadas medidas.

Custa a partir de US$ 0,38 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque posts dentro de um único subreddit por consulta, ordenação e período. Pagine com o campo cursor. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,5% das chamadas ao endpoint Busca no subreddit da API para Reddit feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,2 segundos, em 6.014 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.