Reddit App Fetch Subreddit Settings
Retrieve a Reddit subreddit's settings, including posting permissions, content options, and flair configuration. This is a read-only lookup. Inputs: - subreddit_id (required): The full subreddit ID, for example t5_2qh0u. It must start with t5_ followed by 1–17 lowercase letters or digits. Use the ID from subreddit information, not a subreddit name or URL. - language (optional): Preferred response language as an IETF language tag, such as en-US. Length: 2–16 characters; default: en-US. - need_format (optional): Whether to request data cleaning and formatting; default: false. Returns a JSON response with subreddit settings in data. Documented settings include subredditType (public/private/restricted), submissionType (any/link/self), allowImages, allowVideos, allowPolls, suggestedCommentSort, spoilersEnabled, allowedPostTypes, contentOptions, and flairSettings. These describe community visibility, accepted submissions, media permissions, comment sorting, spoiler support, and user/post flair. The data schema is flexible and may be null; individual fields are not guaranteed. Example inputs: {"subreddit_id":"t5_2qh0u","language":"en-US","need_format":false}.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed fee of 2.07 credits is charged per call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
language | string | No | 返回内容使用的语言,采用 IETF 语言标签;默认 en-US / Preferred response language as an IETF language tag; default: en-US | en-US |
need_format | boolean | No | 是否需要清洗数据/Whether to clean and format the data | false |
subreddit_id | string | Yes | 版块ID/Subreddit ID | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_reddit_app_fetch_subreddit_settings' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"subreddit_id": "xxx"
}
}'No response example available yet.

