> ## Documentation Index
> Fetch the complete documentation index at: https://docs.konbiniapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get subreddits in batch

> Returns up to 100 Reddit subreddits by ID in a single request. Costs 1 credit per ID submitted.

## What it does

Returns up to 100 Reddit subreddits by ID in a single request. Costs 1 credit per ID submitted.

## Tool details

| Field         | Value                              |
| ------------- | ---------------------------------- |
| Tool name     | `reddit_get_subreddits_batch`      |
| Platform      | Reddit                             |
| REST endpoint | `POST /v1/reddit/subreddits/batch` |
| Result type   | Detail tool                        |

## Parameters

| Parameter           | Type       | Required | Description                                                                                    |
| ------------------- | ---------- | -------- | ---------------------------------------------------------------------------------------------- |
| `entityIds`         | `string[]` | Yes      | Example: `["2qh3l","2qh0u"]`.                                                                  |
| `projection_preset` | `string`   | No       | Defaults to `minimal`. Allowed values: `full`, `minimal`, `identity`, `engagement`, `content`. |
| `data_fields`       | `string[]` | No       | Adds top-level keys from `data` on top of the selected `projection_preset`.                    |

## Example

```json theme={null}
{
  "name": "reddit_get_subreddits_batch",
  "arguments": {
    "entityIds": [
      "2qh3l",
      "2qh0u"
    ],
    "projection_preset": "minimal",
    "data_fields": [
      "itemCount",
      "type",
      "items"
    ]
  }
}
```

## Available data fields

* `@context`
* `type`
* `itemCount`
* `items`

## Response notes

Successful calls return a JSON object with a top-level `data` field and, when
available, `metadata.creditsUsed` and `metadata.creditsRemaining`. See
[response format](/getting-started/response-format),
[pagination](/getting-started/pagination), and [credits](/getting-started/credits).