# Subreddits



<MethodPage method="GET" path="/v1/reddit/subreddits" credits={1}>
  <MethodSignature name="listSubreddits" args={[{ name: "options", optional: true }]} returns="Listing<Subreddit>" />

  Lists Reddit's popular subreddits, or the newest ones. To find subreddits about a topic, use [Search](/reddit/search) with `type=subreddit`. 1 credit per page of up to 100 subreddits; see [Listings and pages](/listings).

  <Security permission="reddit:read" />

  <SchemaGroup title="Query parameters">
    <SchemaField name="sort" type="string" optional location="query">
      `popular` (default) or `new`.
    </SchemaField>

    <SchemaField name="limit" type="integer" optional location="query">
      Subreddits per page, 1 to 100. Default `25`.
    </SchemaField>

    <SchemaField name="after" type="string" optional location="query">
      The previous page's `after`, for the next page.
    </SchemaField>

    <SchemaField name="nsfw" type="boolean" optional location="query">
      Include subreddits marked NSFW. Default `false`.
    </SchemaField>
  </SchemaGroup>

  <div id="returns" className="mt-8">
    Response [#response]

    ```jsonc
    {
      "subreddit": null,
      "query": null,
      "sort": "popular",
      "count": 3,
      "items": [
        {
          "name": "Home",
          "title": "Home",
          "public_description": "",
          "description": "Everything home related: interior design, home improvement, architecture.\n\n…",
          "subscribers": 432839,
          "created_at": "2009-01-25T02:25:57Z",
          "over_18": false,
          "type": "public",
          "url": "/r/Home/"
        }
      ],
      "after": "t5_2w844",
      "filtered_nsfw": 0
    }
    ```

    Items have the fields of [Subreddit about](/reddit/subreddit-about) without the rules.
  </div>

  <MethodSamples>
    <LanguageSample language="cURL">
      ```bash
      curl "https://api.threadapi.dev/v1/reddit/subreddits?sort=new&limit=100" \
        -H "Authorization: Bearer $THREADAPI_API_KEY"
      ```
    </LanguageSample>
  </MethodSamples>
</MethodPage>