Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Subreddit Posts

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Reddit

​

Public communities, posts, comments and search.

Reddit Operations

Subreddit Posts

​

Returns the post stream of one subreddit with an after token to page. Posts carry the same fields as get_reddit_search, including title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink and subreddit_subscribers. sort accepts best, hot, new, top and rising. Important: timeframe is only accepted together with sort=top, and any other combination returns 400 rather than ignoring the parameter. Subreddit names are case-sensitive. To search inside the same subreddit use get_reddit_subreddit_search, and for its metadata use get_reddit_subreddit_details.

Query Parameters
  • subreddit
    Type: string
    required

    Subreddit name

  • timeframe
    Type: string enum

    Timeframe to get posts from. Runtime requires sort=top when timeframe is provided.

    values
    • all
    • day
    • week
    • month
    • year
  • sort
    Type: string enum

    Sort order

    values
    • best
    • hot
    • new
    • top
    • rising
  • after
    Type: string

    After to get more posts. Get 'after' from previous response.

  • trim
    Type: boolean

    Set to true for a trimmed down version of the response

Responses
  • 200
    Type: object · RedditPostsResponse

    Successful response

    • after
      Type: string nullable
    • credits_remaining
      Type: integer

      Integer numbers.

    • cursor
      Type: string nullable
    • posts
      Type: array object[] · RedditPost[]
      • propertyName
        Type: anything
    • success
      Type: boolean
    • propertyName
      Type: anything
    application/json
  • 400
    Type: object

    Bad request, for example when timeframe is provided with a sort other than top.

    • credits_remaining
      Type: integer

      Integer numbers.

    • error
      Type: string
    • errorStatus
      Type: integer

      Integer numbers.

    • message
      Type: string
    • success
      Type: boolean
    • propertyName
      Type: anything
    application/json
  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/reddit/subreddit
curl 'https://openapi.felo.ai/v1/beta/reddit/subreddit?subreddit=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "posts": [
    {
      "id": "1lfbo7u",
      "author": "Vetro_Nodulare2",
      "author_fullname": "t2_16syu27ar1",
      "subreddit": "AskReddit",
      "title": "What is a thing you love that lots of people hate?",
      "downs": 0,
      "name": "t3_1lfbo7u",
      "upvote_ratio": 0.9,
      "ups": 45,
      "total_awards_received": 0,
      "score": 45,
      "created": 1750341959,
      "num_comments": 349,
      "url": "https://www.reddit.com/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/",
      "subreddit_subscribers": 56146328,
      "is_video": false,
      "created_utc": 1750341959
    }
  ],
  "after": "t3_1lfogps"
}

Successful response

Subreddit Posts