# Reddit Community Profile (`truefetch/reddit-community-profile`) Actor

Reddit community profile API returning 67 structured fields for one subreddit — descriptions, subscriber counts, settings, brand assets, pinned posts, rules, and wiki pages. From $0.0375 per result plus Actor Start.

- **URL**: https://apify.com/truefetch/reddit-community-profile.md
- **Developed by:** [TrueFetch](https://apify.com/truefetch) (community)
- **Categories:** Social media, Developer tools, Automation
- **Stats:** 109 total users, 13 monthly users, 100.0% runs succeeded, 8 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.0375 / result

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**Reddit Community Profile is a reddit community profile API that converts one known subreddit into a 67-field record with subscriber facts, settings, brand assets, public rules, readable wiki pages, and pinned posts.** It provides a stable Dataset, API, and MCP contract without requiring you to parse changing page HTML.

Use it to qualify communities before post collection, maintain a dated community catalog, compare public rules and settings, or enrich a known subreddit identifier inside an automation.

### What does Reddit Community Profile do?

**It reads one public Reddit community and returns at most one structured profile row.** The row covers identity, descriptions, subscriber count, access type, content permissions, submission controls, brand assets, rules, wiki content, pinned posts, and processing provenance.

The Actor uses Reddit's public signed-out web surface. It does not require your Reddit credentials, use the official Reddit Data API, bypass authentication, enumerate members or moderators, collect a post feed, or infer private facts. Optional values remain absent when the source does not expose them.

### How do I run Reddit Community Profile?

**Enter one community and start the Actor.** The public prefill is:

```json
{
  "community": "python"
}
```

1. Open the [Actor input page](https://apify.com/truefetch/reddit-community-profile/input).
2. Enter a plain name, `r/name` path, or standard Reddit community URL.
3. Click **Start**.
4. Read the single row from the default Dataset.

The `python` prefill returns one row with 11 rules, 10 wiki pages and two pinned posts, in about 76 seconds. Live values and runtime can change.

### What data does Reddit Community Profile return?

**A successful lookup uses a complete 67-field top-level contract.** Any individual row can omit optional fields Reddit did not expose.

| Group | Complete field list |
|---|---|
| Identity and text | `id`, `name`, `url`, `about`, `description`, `title`, `header_title`, `created` |
| Classification and audience | `ad_category`, `content_category`, `type`, `language`, `subscribers`, `ad_whitelist` |
| Brand assets and colors | `icon`, `icon_size`, `banner`, `banner_size`, `mobile_banner`, `header_image`, `header_size`, `primary_color`, `key_color`, `theme_background_color` |
| Visibility and comment media | `over_18`, `hide_ads`, `show_media`, `show_media_preview`, `comments_media_enabled`, `comment_attachment_types`, `quarantine` |
| Content capabilities | `allow_images`, `allow_videos`, `allow_galleries`, `allow_polls`, `allow_talks`, `allow_discovery`, `allow_predictions`, `wiki_enabled`, `spoilers_enabled`, `emojis_enabled`, `emoji_size` |
| Submission and participation | `submission_type`, `submit_external_label`, `submit_text`, `submit_text_label`, `suggested_comment_sort`, `score_hide_mins`, `archive_posts`, `original_tag`, `accept_followers`, `restrict_posting`, `restrict_commenting` |
| Governance and display | `community_reviewed`, `crosspostable`, `post_flair_enabled`, `post_flair_position`, `collapse_deleted_comments`, `free_form_reports`, `disable_contributor_requests`, `has_menu_widget`, `public_traffic` |
| Nested resources and provenance | `rules`, `wikis`, `stickies`, `processor`, `processed_at` |

`rules` preserves order and public rule details. `wikis` returns up to 25 indexed readable pages with Markdown and edit metadata. `stickies` returns up to two pinned posts with engagement, state, flair, text, and media fields.

```json
{
  "name": "Python",
  "url": "https://www.reddit.com/r/python/",
  "type": "public",
  "language": "en",
  "subscribers": 1504135,
  "allow_images": false,
  "rules": [{"priority": 0, "name": "No showcase posts"}],
  "wikis": [{"name": "index", "content": "Public wiki Markdown"}],
  "stickies": [{"title": "Showcase Thread"}],
  "processed_at": "2026-08-12T12:15:58+00:00"
}
```

The example above is abbreviated; live counts and content change.

### What inputs can I configure?

**There is exactly one input.**

- **`community`** (required string, prefill `python`) — accepts a plain subreddit name, `r/name`, `/r/name`, or a standard `reddit.com/r/name` URL.

Query strings, fragments, malformed URLs, user profiles, and post URLs are rejected. The Actor does not accept lists, post limits, member filters, credentials, or geographic filters.

### What platforms and markets does Reddit Community Profile cover?

**Coverage is Reddit-wide at the community level, not country-filtered.** Any community addressable by a standard `reddit.com/r/name` URL can be requested, but the returned facts depend on what its public surface exposes.

Public and some restricted communities can return useful profiles. Private, banned, renamed, quarantined, access-walled, malformed, or temporarily unavailable communities can expose less data or no row. The Actor does not cross access controls.

### Why use Reddit Community Profile?

| Capability | Practical value |
|---|---|
| One row with 67 documented field names | Load profile snapshots without maintaining HTML selectors |
| Rules plus readable wiki Markdown | Compare public policy and documentation context |
| Subscriber, access, and posting settings | Qualify known communities before downstream collection |
| Icon, banner, header, colors, and pinned-post media | Build community catalogs and dashboards |
| `processor` and `processed_at` provenance | Date, diff, and audit successive snapshots |

### Who is Reddit Community Profile for?

- Developers replacing brittle subreddit-page parsing with a stable API shape.
- Analysts comparing public settings, rules, and wiki documentation.
- Data teams maintaining a researched set of community snapshots.
- Automation builders enriching a known subreddit before collecting posts.
- Trust-and-safety teams doing human-reviewed public-source research.

It is not a member directory, moderator list, post feed, audience-authenticity score, or safety rating. Do not use it for harassment, deanonymization, access-control evasion, or consequential decisions about individuals.

### How can I use Reddit Community Profile through the API or MCP?

**Call `truefetch/reddit-community-profile` through the Apify API or load its live schema through Apify MCP.** Keep tokens in environment variables and bound automated charges.

```bash
curl -X POST "https://api.apify.com/v2/acts/truefetch~reddit-community-profile/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"community":"python"}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("truefetch/reddit-community-profile").call(
    run_input={"community": "python"},
    max_total_charge_usd=0.06,
)
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
```

For MCP, connect a compatible client to [Apify MCP](https://mcp.apify.com), fetch the Actor details, then call the Actor with the same input. The [API page](https://apify.com/truefetch/reddit-community-profile/api) provides current endpoints and client examples.

### How much does Reddit Community Profile cost?

One community profile costs $0.05000 on the FREE tier, plus a $0.01000 Actor Start per run — so the smallest useful run is $0.06000. Actor Start is charged once according to requested memory, with a minimum of one event; Result is charged once when a profile row is written.

| Event | FREE | BRONZE | SILVER | GOLD / PLATINUM / DIAMOND |
|---|---:|---:|---:|---:|
| Actor Start, minimum | $0.01000 | $0.01000 | $0.01000 | $0.01000 |
| Result | $0.05000 | $0.04500 | $0.04000 | $0.03750 |

A successful one-result FREE run therefore costs at most **$0.06000** at the minimum start charge. Empty or failed runs can still incur Actor Start, and higher requested memory can raise the start charge. Confirm the [live pricing page](https://apify.com/truefetch/reddit-community-profile/pricing) and set `maxTotalChargeUsd` before automating.

### How does Reddit Community Profile compare with alternatives?

Manual browsing works for one one-off lookup but produces no reusable record. A generic browser crawler captures HTML, but you own selector drift, retries, nested wiki reads, media handling, and schema maintenance. An official Reddit integration may be appropriate if you have approved access and need endpoints beyond this public profile.

Choose [Reddit Community Post](https://apify.com/truefetch/reddit-community-post) when the records should be posts, [Reddit Usernames Scraper](https://apify.com/truefetch/reddit-usernames-scraper) when public participant usernames are the target, [Reddit User Profile](https://apify.com/truefetch/reddit-user-profile) for a known username, or [Reddit Search API](https://apify.com/truefetch/reddit-search-api) when discovery begins with a keyword.

### What are the limits and troubleshooting steps?

- **No row:** check spelling and retry with the plain name; banned, private, renamed, malformed, or unavailable communities may return nothing.
- **Reduced row:** restricted or access-walled communities can expose fewer public facts.
- **Absent optional field:** preserve absence; it is not equivalent to `false`, zero, or an empty string.
- **Empty `wikis`:** the wiki is disabled or no indexed page was readable; the cap is 25 pages.
- **Fewer pinned posts:** Reddit exposes at most two, and a community may pin none.
- **Missing media:** a community may not configure the asset; failed downloads retain a public source URL when available.
- **Long runtime:** wiki-heavy communities need more browser work — the ten-wiki `python` case takes around 76 seconds.
- **Memory:** the Actor runs at 256 MB and accepts up to 512 MB. Lower is not offered because the browser needs this much to finish a page.

For a reproducible issue report, include the run ID, exact input, expected behavior, and observed status, with tokens and personal information removed.

Reddit Community Profile is an independent tool and is not affiliated with, endorsed by, or sponsored by Reddit, Inc. Reddit and the Reddit logo are trademarks of Reddit, Inc.

### Frequently asked questions

#### Is this a subreddit stats scraper?

Yes. It returns the source-reported subscriber count, creation time, access type, language, content settings, and `processed_at` timestamp for one community. Store successive rows if you need a trend.

#### How to look up subreddit subscriber count with the API?

Pass the community name and read `subscribers` from the returned row. Treat it as a dated source snapshot, not a guaranteed real-time or independently verified audience count.

#### Can I process several subreddits in one run?

No. One run accepts one community and returns at most one row. Schedule or loop bounded independent runs for a list.

#### Does it return moderators, members, posts, or comments?

No. It returns community profile facts, public rules, readable wiki pages, and up to two pinned posts. It does not enumerate moderators or members and does not collect a feed.

#### Why are some fields absent?

Reddit does not expose every optional field for every community. Absence is preserved instead of being replaced by a guessed default.

#### Can the same input change tomorrow?

Yes. Counts, descriptions, rules, wikis, settings, assets, and pinned posts are live source data. Use `processed_at` to date the row.

### Related TrueFetch Actors

- [Reddit Community Post](https://apify.com/truefetch/reddit-community-post) — collect post records from a known community.
- [Reddit User Profile](https://apify.com/truefetch/reddit-user-profile) — profile one known Reddit username.
- [Reddit Search API](https://apify.com/truefetch/reddit-search-api) — find posts across communities by keyword.

### Support

Open a reproducible problem on the [Actor issues page](https://apify.com/truefetch/reddit-community-profile/issues) with the run ID and exact input, or ask a product question in the [TrueFetch community group](https://t.me/TrueFetch). See the [Apify MCP guide](https://docs.apify.com/integrations/mcp) for client setup.

**Last Updated:** August 15, 2026

# Actor input Schema

## `community` (type: `string`):

Reddit community name, r/name path, or reddit.com/r/name URL. Use a plain name for the smallest request

## Actor input object example

```json
{
  "community": "python"
}
```

# Actor output Schema

## `results` (type: `string`):

Normalized Reddit community profile records in the default Dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "community": "python"
};

// Run the Actor and wait for it to finish
const run = await client.actor("truefetch/reddit-community-profile").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "community": "python" }

# Run the Actor and wait for it to finish
run = client.actor("truefetch/reddit-community-profile").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "community": "python"
}' |
apify call truefetch/reddit-community-profile --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,truefetch/reddit-community-profile"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/EMV1QDp4tfmdUWeo5/builds/xUyCPbnTu2ATMzBD3/openapi.json