# Read what a post may choose

> Page: https://docs.flung.dev/reference/api/get-v1-accounts-id-posting-options. Index of every page: https://docs.flung.dev/llms.txt

TikTok only: the creator's name, the audiences they may post to, which interactions they turned off and the longest video allowed, read from TikTok now.

`GET /v1/accounts/{id}/posting-options`

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Read what a post may choose. |
| What does it need? | An API key or an OAuth access token. |
| What does it take? | `id` in the path. |
| What does it return? | Status 200 with a body of type [`PostingOptions`](https://docs.flung.dev/reference/api/schemas.md#postingoptions). |
| In the SDK? | `flung.accounts.postingOptions()` |
| As an MCP tool? | [`get_posting_options`](https://docs.flung.dev/reference/mcp/get-posting-options.md) |
| What can go wrong? | `401` Missing, unknown, revoked or expired API key; `404` No such account in this workspace; `422` The request failed validation; `429` Too many requests for this credential; wait for `retry-after` seconds. Every failure has the same [error shape](https://docs.flung.dev/reference/api/errors.md). |

## What it does

TikTok only: the creator's name, the audiences they may post to, which interactions they turned off and the longest video allowed, read from TikTok now. TikTok asks apps to show these and let the person choose before each post.

## Example

**curl**

```bash
curl -X GET 'https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa/posting-options' \
  --header "Authorization: Bearer $FLUNG_API_KEY"
```

**TypeScript**

```ts
import { Flung } from '@flung.dev/sdk'

const flung = new Flung({ apiKey: process.env.FLUNG_API_KEY! })
const result = await flung.accounts.postingOptions({
  id: 'acct_aaaaaaaaaaaaaaaaaaaaaaaa',
})
```

**fetch**

```js
const response = await fetch('https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa/posting-options', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.FLUNG_API_KEY}`,
  },
})
if (!response.ok) throw new Error((await response.json()).error.message)
const result = await response.json()
```

A successful answer looks like this:

```json
{
  "creatorName": "string",
  "privacyLevels": [
    "PUBLIC_TO_EVERYONE",
    "SELF_ONLY"
  ],
  "commentsDisabled": true,
  "duetDisabled": true,
  "stitchDisabled": true,
  "maxVideoSeconds": 1
}
```

## Path parameters

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | `string` | yes |  |

## Responses

| Status | Meaning | Body |
|---|---|---|
| 200 | The options. | [`PostingOptions`](https://docs.flung.dev/reference/api/schemas.md#postingoptions) |
| 401 | Missing, unknown, revoked or expired API key. | [`Error`](https://docs.flung.dev/reference/api/schemas.md#error) |
| 404 | No such account in this workspace. | [`Error`](https://docs.flung.dev/reference/api/schemas.md#error) |
| 422 | The request failed validation. | [`Error`](https://docs.flung.dev/reference/api/schemas.md#error) |
| 429 | Too many requests for this credential; wait for `retry-after` seconds. | [`Error`](https://docs.flung.dev/reference/api/schemas.md#error) |

## Response body

A 200 answer has the type [`PostingOptions`](https://docs.flung.dev/reference/api/schemas.md#postingoptions).

| Field | Type | Required | Description |
|---|---|---|---|
| `creatorName` | `string \| null` | yes |  |
| `privacyLevels` | `string[]` | yes | The audiences this account may post to now; pass one as platformOverrides.tiktok.privacyLevel. |
| `commentsDisabled` | `boolean` | yes | The creator turned comments off; posts cannot allow them. |
| `duetDisabled` | `boolean` | yes |  |
| `stitchDisabled` | `boolean` | yes |  |
| `maxVideoSeconds` | `integer \| null` | yes |  |

## See also

| Doc | Why |
|---|---|
| [API reference](https://docs.flung.dev/reference/api.md) | Every endpoint |
| [Schemas](https://docs.flung.dev/reference/api/schemas.md) | Every request and response type |
| [Errors](https://docs.flung.dev/reference/api/errors.md) | Every error code and what to do about it |
| [`get_posting_options`](https://docs.flung.dev/reference/mcp/get-posting-options.md) | The same operation as an MCP tool |