# Reddit New Subreddits (`datamagnet/reddit-new-subreddits`) Actor Get a clean list of the newest subreddits available at run time. Choose how many results you want and export the output easily for review or analysis. - **URL**: https://apify.com/datamagnet/reddit-new-subreddits.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, News - **Stats:** 2 total users, 1 monthly users, 20.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## New Subreddits List Get the newest subreddit entries in a clean, easy-to-review list. ### What it does - Finds the latest subreddit entries available when you run it. - Lets you choose how many results you want back. - Keeps loading more results automatically until your limit is reached. - Returns the data in a simple format that is easy to read or export. - Includes a short run summary so you can quickly see how many results were returned. ### Use cases - Track newly created communities in a niche so you can spot trends, competitors, or emerging topics early. - Build a daily watchlist of fresh subreddits for moderation, outreach, or community research. - Quickly review new subreddit names and descriptions to find communities worth joining, following, or analyzing. ### Input | Field | Description | Required | Example | |---|---|---:|---:| | max_results | Choose how many subreddit results you want returned in total. The actor will automatically gather more results if needed. | No | `25` | ### Output | Field | Description | |---|---| | accept_followers | Whether the subreddit allows followers. | | advertiser_category | The advertiser category set for the subreddit, if any. | | all_original_content | Whether the subreddit is marked for original content only. | | allow_discovery | Whether the subreddit can be discovered in Reddit search and recommendations. | | allow_galleries | Whether gallery posts are allowed. | | allow_images | Whether image posts are allowed. | | allow_polls | Whether poll posts are allowed. | | allow_prediction_contributors | Whether users can contribute to predictions. | | allow_predictions | Whether predictions are enabled. | | allow_predictions_tournament | Whether prediction tournaments are enabled. | | allow_talks | Whether talk posts are allowed. | | allow_videogifs | Whether video GIF posts are allowed. | | allow_videos | Whether video posts are allowed. | | allowed_media_in_comments | The types of media allowed in comments. | | banner_background_color | The banner background color, if set. | | banner_background_image | The banner background image URL, if set. | | banner_img | The main banner image URL, if set. | | banner_size | The banner size, if available. | | can_assign_link_flair | Whether link flair can be assigned. | | can_assign_user_flair | Whether user flair can be assigned. | | collapse_deleted_comments | Whether deleted comments are collapsed by default. | | comment_contribution_settings | Settings that control what media types are allowed in comments. | | comment_score_hide_mins | How long comment scores are hidden, in minutes. | | community_icon | The community icon image URL. | | community_reviewed | Whether the community has been reviewed. | | created | The subreddit creation time as a Unix timestamp. | | created_utc | The subreddit creation time in UTC as a Unix timestamp. | | description | The subreddit description text. | | description_html | The subreddit description in HTML format. | | disable_contributor_requests | Whether contributor requests are disabled. | | display_name | The subreddit name without the r/ prefix. | | display_name_prefixed | The subreddit name with the r/ prefix. | | emojis_custom_size | The custom emoji size setting, if available. | | emojis_enabled | Whether custom emojis are enabled. | | free_form_reports | Whether free-form reports are allowed. | | has_menu_widget | Whether the subreddit has a menu widget. | | header_img | The header image URL, if set. | | header_size | The header image size, if available. | | header_title | The header title text, if set. | | hide_ads | Whether ads are hidden in the subreddit. | | icon_img | The subreddit icon image URL. | | icon_size | The icon size, if available. | | id | The subreddit ID. | | is_crosspostable_subreddit | Whether the subreddit can be crossposted to. | | is_enrolled_in_new_modmail | Whether the subreddit is enrolled in new modmail. | | key_color | The subreddit key color, if set. | | lang | The subreddit language code. | | link_flair_enabled | Whether link flair is enabled. | | link_flair_position | Where link flair appears. | | mobile_banner_image | The mobile banner image URL. | | name | The internal subreddit name. | | notification_level | The notification level, if available. | | original_content_tag_enabled | Whether the original content tag is enabled. | | over18 | Whether the subreddit is marked 18+. | | prediction_leaderboard_entry_type | The prediction leaderboard entry type. | | primary_color | The subreddit primary color. | | public_description | The public-facing subreddit description. | | public_description_html | The public-facing description in HTML format. | | public_traffic | Whether public traffic stats are shown. | | quarantine | Whether the subreddit is quarantined. | | restrict_commenting | Whether commenting is restricted. | | restrict_posting | Whether posting is restricted. | | should_archive_posts | Whether posts should be archived. | | should_show_media_in_comments_setting | Whether media should be shown in comments. | | show_media | Whether media is shown. | | show_media_preview | Whether media previews are shown. | | spoilers_enabled | Whether spoiler tags are enabled. | | submission_type | What type of submissions are allowed. | | submit_link_label | The label shown for link submissions. | | submit_text | The submission text shown to users. | | submit_text_html | The submission text in HTML format. | | submit_text_label | The label shown for submission text. | | subreddit_type | The subreddit type, such as public or restricted. | | subscribers | The subscriber count. | | suggested_comment_sort | The suggested comment sort order, if set. | | title | The subreddit title. | | url | The subreddit URL path. | | user_can_flair_in_sr | Whether the current user can use flair in the subreddit. | | user_flair_background_color | The user flair background color, if available. | | user_flair_css_class | The user flair CSS class, if available. | | user_flair_enabled_in_sr | Whether user flair is enabled in the subreddit. | | user_flair_position | Where user flair appears. | | user_flair_richtext | Rich text flair content, if available. | | user_flair_template_id | The user flair template ID, if available. | | user_flair_text | The user flair text, if available. | | user_flair_text_color | The user flair text color, if available. | | user_flair_type | The user flair type. | | user_has_favorited | Whether the user has favorited the subreddit. | | user_is_banned | Whether the user is banned from the subreddit. | | user_is_contributor | Whether the user is a contributor. | | user_is_moderator | Whether the user is a moderator. | | user_is_muted | Whether the user is muted. | | user_is_subscriber | Whether the user is subscribed. | | user_sr_flair_enabled | Whether subreddit flair is enabled for the user. | | user_sr_theme_enabled | Whether the subreddit theme is enabled for the user. | | videostream_links_count | The number of videostream links. | | wiki_enabled | Whether the wiki is enabled. | | wls | The subreddit warning level, if available. | | kind | The item type identifier. | ### Sample output ```json { "accept_followers": true, "advertiser_category": "", "all_original_content": false, "allow_discovery": true, "allow_galleries": true, "allow_images": true, "allow_polls": true, "allow_prediction_contributors": false, "allow_predictions": false, "allow_predictions_tournament": false, "allow_talks": false, "allow_videogifs": true, "allow_videos": true, "allowed_media_in_comments": [ "giphy", "static", "animated", "expression", "video" ], "banner_background_color": "", "banner_background_image": "https://styles.redditmedia.com/t5_ismhl2/styles/bannerBackgroundImage_d48anpuovzah1.png?width=4000&s=25842149eab9aaa738bcdb5beb36911aaae045c2", "banner_img": "", "banner_size": null, "can_assign_link_flair": false, "can_assign_user_flair": false, "collapse_deleted_comments": true, "comment_contribution_settings": { "allowed_media_types": [ "giphy", "static", "animated", "expression", "video" ] }, "comment_score_hide_mins": 0, "community_icon": "https://styles.redditmedia.com/t5_ismhl2/styles/communityIcon_lhbugpuovzah1.png?width=256&s=2fb50d3d05a919139708e7de6ff17a8dd526cb5e", "community_reviewed": false, "created": 1783075758, "created_utc": 1783075758, "description": "Partage de son expérience sur les Huawei Watch Fit 5 et Fit 5 Pro.", "description_html": "<!-- SC_OFF --><div class=\"md\"><p>Partage de son expérience sur les Huawei Watch Fit 5 et Fit 5 Pro.</p>\n</div><!-- SC_ON -->", "disable_contributor_requests": false, "display_name": "HuaweiWatchFit5", "display_name_prefixed": "r/HuaweiWatchFit5", "emojis_custom_size": null, "emojis_enabled": false, "free_form_reports": false, "has_menu_widget": false, "header_img": null, "header_size": null, "header_title": "", "hide_ads": false, "icon_img": "", "icon_size": null, "id": "ismhl2", "is_crosspostable_subreddit": false, "is_enrolled_in_new_modmail": null, "key_color": "", "lang": "en", "link_flair_enabled": false, "link_flair_position": "", "mobile_banner_image": "https://styles.redditmedia.com/t5_ismhl2/styles/mobileBannerImage_kk41npuovzah1.png", "name": "t5_ismhl2", "notification_level": null, "original_content_tag_enabled": false, "over18": false, "prediction_leaderboard_entry_type": 1, "primary_color": "#0079D3", "public_description": "Partage de son expérience sur les Huawei Watch Fit 5 et Fit 5 Pro.", "public_description_html": "<!-- SC_OFF --><div class=\"md\"><p>Partage de son expérience sur les Huawei Watch Fit 5 et Fit 5 Pro.</p>\n</div><!-- SC_ON -->", "public_traffic": false, "quarantine": false, "restrict_commenting": false, "restrict_posting": true, "should_archive_posts": false, "should_show_media_in_comments_setting": true, "show_media": true, "show_media_preview": true, "spoilers_enabled": true, "submission_type": "any", "submit_link_label": "", "submit_text": "", "submit_text_html": null, "submit_text_label": "", "subreddit_type": "public", "subscribers": 1, "suggested_comment_sort": null, "title": "HuaweiWatchFit5", "url": "/r/HuaweiWatchFit5/", "user_can_flair_in_sr": null, "user_flair_background_color": null, "user_flair_css_class": null, "user_flair_enabled_in_sr": false, "user_flair_position": "right", "user_flair_richtext": [], "user_flair_template_id": null, "user_flair_text": null, "user_flair_text_color": null, "user_flair_type": "text", "user_has_favorited": null, "user_is_banned": null, "user_is_contributor": null, "user_is_moderator": null, "user_is_muted": null, "user_is_subscriber": null, "user_sr_flair_enabled": null, "user_sr_theme_enabled": true, "videostream_links_count": 0, "wiki_enabled": false, "wls": null, "kind": "t5" } ```` # Actor input Schema ## `cursor` (type: `string`): Continue from a previous result page using the cursor value. ## `max_results` (type: `integer`): Choose how many subreddit results you want returned in total. The actor will automatically gather more results if needed. ## Actor input object example ```json { "max_results": 25 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/reddit-new-subreddits").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("datamagnet/reddit-new-subreddits").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call datamagnet/reddit-new-subreddits --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/reddit-new-subreddits", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit New Subreddits", "description": "Get a clean list of the newest subreddits available at run time. Choose how many results you want and export the output easily for review or analysis.", "version": "0.0", "x-build-id": "FdXvUri3RlmKTcyA4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~reddit-new-subreddits/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-reddit-new-subreddits", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datamagnet~reddit-new-subreddits/runs": { "post": { "operationId": "runs-sync-datamagnet-reddit-new-subreddits", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datamagnet~reddit-new-subreddits/run-sync": { "post": { "operationId": "run-sync-datamagnet-reddit-new-subreddits", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "cursor": { "title": "Cursor", "type": "string", "description": "Continue from a previous result page using the cursor value." }, "max_results": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Choose how many subreddit results you want returned in total. The actor will automatically gather more results if needed.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```