Reddit App Subreddit Post Channels

https://api.sandbase.ai/v1/api/reddit/app/subreddit-post-channels

Returns post channel and flair details for a target subreddit. Supports custom sort methods and time range filters.

Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
0 required · 4 optional
Production route

Try the model

Playground

Open playground
Input
Whether to clean and format the data
Time range, supports HOUR, DAY, WEEK, MONTH, YEAR, ALL
Sort method, supports HOT, NEW, TOP, CONTROVERSIAL, RISING
Subreddit name
OutputExample
Responseoutputs · 3.5 KB · 125 lines
[
  {
    "data": {
      "subredditInfoByName": {
        "__typename": "Subreddit",
        "postFlairTemplates": [
          {
            "id": "f988392c-41f4-11ea-856e-0e3f43166111",
            "isModOnly": false,
            "richtext": null,
            "text": "Arts/Crafts"
          },
          {
            "id": "260873e0-c9b8-11e5-be06-0ecbb6f4dd8d",
            "isModOnly": false,
            "richtext": null,
            "text": "Politics"
          },
          {
            "id": "66cf8d7a-8718-11e9-803a-0e44312dcdb8",
            "isModOnly": false,
            "richtext": null,
            "text": "Misleading Title"
          },
          {
            "id": "2d9ae03a-cbd3-11e5-94f0-0eea8ef60395",
            "isModOnly": false,
            "richtext": null,
            "text": "Picture of text"
          },
          {
            "id": "1fd2615c-c9b8-11e5-a106-0e47f9bd707d",
            "isModOnly": false,
            "richtext": null,
            "text": "Backstory"
          },
          {
            "id": "e43df516-e8f9-11e8-8bdf-0ec71fb13d9c",
            "isModOnly": false,
            "richtext": null,
            "text": "! Broken Link !"
          },
          {
            "id": "9144ca30-b41a-11f0-a5e5-bab1ece82e7c",
            "isModOnly": false,
            "richtext": null,
            "text": "OC"
          },
          {
            "id": "9f2f09de-e154-11e9-9b7f-0e4b02470cc4",
            "isModOnly": false,
            "richtext": null,
            "text": "uncivil/7 day ban"
          },
          {
            "id": "a768ac40-e154-11e9-88c3-0e2175216af4",
            "isModOnly": false,
            "richtext": null,
            "text": "uncivil/ban"
          },
          {
            "id": "d4931296-e154-11e9-821a-0e0830f0378c",
            "isModOnly": false,
            "richtext": null,
            "text": "spam/ban"
          },
          {
            "id": "1aaffde0-873d-11e1-a158-12313b08a511",
            "isModOnly": false,
            "richtext": null,
            "text": "r3: gratuitous"
          },
          {
            "id": "86d860a2-873d-11e1-8aab-12313d2c1af1",
            "isModOnly": false,
            "richtext": null,
            "text": "r4: no pi"
          },
          {
            "id": "f3540c8c-aeba-11e1-b874-12313b078981",
            "isModOnly": false,
            "richtext": null,
            "text": "r5: title guidelines"
          },
          {
            "id": "6473d42a-aee7-11e1-885f-12313d051e91",
            "isModOnly": false,
            "richtext": null,
            "text": "r6: bad host"
          },
          {
            "id": "fed7622a-aeba-11e1-817b-12313d051e91",
            "isModOnly": false,
            "richtext": null,
            "text": "R6: Indirect Link"
          },
          {
            "id": "31d36ec2-e349-11e1-a6a1-12313d051e91",
            "isModOnly": false,
            "richtext": null,
            "text": "r7: animated"
          },
          {
            "id": "2b4de71e-fd6e-11e1-b6c7-12313b0ce1e2",
            "isModOnly": false,
            "richtext": null,
            "text": "r9: progresspic"
          },
          {
            "id": "8fbc89f2-a303-11e9-ad41-0ed60e30de86",
            "isModOnly": false,
            "richtext": null,
            "text": "R11: Front Page Repost"
          },
          {
            "id": "db8d2b8e-31aa-11f0-b76e-0ee6b4914630",
            "isModOnly": false,
            "richtext": null,
            "text": "r1: ai generated image"
          }
        ]
      }
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.0015 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

need_format
boolean · optional
range
string · optional
sort
string · optional
subreddit_name
string · optional

Access

Provider
Reddit
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/reddit/app/subreddit-post-channels
Authentication
Bearer API key

API README

Reddit App Subreddit Post Channels API

Access subreddit channel metadata and flair templates using subreddit_name, with options for sort and range filtering.

Use cases

  • Retrieve post channel and flair templates for a community.
  • Inspect subreddit channel settings sorted by hot or top activity.
  • Extract flair identifiers to categorize community posts.

Request

curl -X POST "https://api.sandbase.ai/v1/api/reddit/app/subreddit-post-channels" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

NameTypeRequiredDescription
sortstringNoSort method, supports HOT, NEW, TOP, CONTROVERSIAL, RISING
rangestringNoTime range, supports HOUR, DAY, WEEK, MONTH, YEAR, ALL
need_formatbooleanNoWhether to clean and format the data
subreddit_namestringNoSubreddit name

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "subredditInfoByName": {
    "postFlairTemplates": [
      {
        "id": "f988392c-41f4-11ea-856e-0e3f43166111",
        "text": "Arts/Crafts"
      }
    ]
  }
}

Notes

  • Supported sort values include HOT, NEW, TOP, CONTROVERSIAL, and RISING.
  • Supported range values include HOUR, DAY, WEEK, MONTH, YEAR, and ALL.
  • Set need_format to true to return cleaned and formatted data.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/reddit/app/subreddit-post-channels
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/reddit/app/subreddit-post-channels" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "sort": "HOT",
  "range": "DAY",
  "need_format": false,
  "subreddit_name": "pics"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Reddit$0.0015 per callJSONJul 31, 2026
Reddit$0.0015 per callJSONJul 31, 2026
Reddit$0.0015 per callJSONJul 31, 2026
Reddit$0.0015 per callJSONJul 31, 2026
Reddit$0.0015 per callJSONJul 31, 2026
Reddit$0.0015 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Reddit App Subreddit Post Channels API?

Send a POST request to https://api.sandbase.ai/v1/api/reddit/app/subreddit-post-channels with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Reddit App Subreddit Post Channels API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Reddit App Subreddit Post Channels API accept?

No parameters are required. Optional: need_format (boolean), range (string), sort (string) and subreddit_name (string). The Parameters table and the Playground on this page list every field.

What does the Reddit App Subreddit Post Channels API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Reddit developer account or API key?

No. Reddit App Subreddit Post Channels runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Reddit API access separately.