# TikTok creator info

> What a TikTok creator currently allows, to read before a Direct Post.

Canonical: <https://www.tryadeli.com/docs/api/posts/get-tiktok-creator-info>

`GET https://app.tryadeli.com/api/v1/posts/tiktok/creator-info`

Authorization: `Bearer <API key>` — see [Authentication](https://www.tryadeli.com/docs/authentication)

Recommended before a Direct Post: TikTok revalidates what the creator currently
allows, and those capabilities change. Use the response to build your UI and to
pick a legal photo `privacy_level` for [Publish to TikTok](https://www.tryadeli.com/docs/api/posts/publish-tiktok).
`nickname` is the account's display name.

**Query parameters**

| Name        | Type   | Required | Description                                                                       |
| ----------- | ------ | -------- | --------------------------------------------------------------------------------- |
| `accountId` | `uuid` | Yes      | A connected TikTok account.                                                       |
| `profileId` | `uuid` |          | Optional, because accountId names its profile. If you pass both, they must agree. |

## Request examples

**cURL**

```bash
curl --fail-with-body "https://app.tryadeli.com/api/v1/posts/tiktok/creator-info?accountId=00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer $ADELI_API_KEY"
```

**JavaScript**

```javascript
const response = await fetch("https://app.tryadeli.com/api/v1/posts/tiktok/creator-info?accountId=00000000-0000-0000-0000-000000000000", {
  headers: {
    Authorization: `Bearer ${process.env.ADELI_API_KEY}`,
  },
});
console.log(await response.json());
```

**Python**

```python
import os

import requests

response = requests.get(
    "https://app.tryadeli.com/api/v1/posts/tiktok/creator-info",
    headers={"Authorization": f"Bearer {os.environ['ADELI_API_KEY']}"},
    params={
        "accountId": "00000000-0000-0000-0000-000000000000",
    },
)
print(response.json())
```

## Responses

### 200

```json
{
  "platform": "tiktok",
  "accountId": "00000000-0000-0000-0000-000000000000",
  "profileId": "00000000-0000-4000-8000-000000000001",
  "creator": {
    "nickname": "Creator",
    "privacyLevelOptions": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "commentDisabled": false,
    "duetDisabled": false,
    "stitchDisabled": false,
    "maxVideoPostDurationSec": 600
  }
}
```

### 422

```json
{
  "error": {
    "code": "connection_expired",
    "message": "TikTok connection requires reconnecting"
  }
}
```