# Networks

> 1 endpoint: list networks and their rules.

- [List networks and their rules](#list-networks-and-their-rules): `GET /v1/networks`

### List networks and their rules

`GET /v1/networks`

Lists every network NOWScale publishes to, with the limits a post must respect there: media kinds, file types and sizes, duration, visibility choices, placements and how many media items one post may carry.

Permission: `accounts:read`

#### Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | `"list"` | Yes |  |
| `data` | array of object | Yes |  |
| `data[].object` | `"network"` | Yes |  |
| `data[].id` | `youtube`, `tiktok`, `instagram`, `facebook`, `threads`, `bluesky`, `mastodon`, `pinterest`, `telegram`, `twitch`, `x`, `discord` | Yes |  |
| `data[].name` | string | Yes |  |
| `data[].visibilities` | array of string | Yes |  |
| `data[].max_media_items` | integer | Yes |  (-9007199254740991 to 9007199254740991) |
| `data[].text_only_posts` | boolean | Yes |  |
| `data[].max_duration_seconds` | integer or null | Yes |  |
| `data[].media_kinds` | array of `video`, `image`, `text` | Yes | What one post may carry on this network. |
| `data[].surfaces` | array of string | Yes | Placements a post can target, such as feed, reel or story. Empty when the network has one. |
| `data[].video` | object or null | Yes |  |
| `data[].image` | object or null | Yes |  |
| `data[].thumbnail` | object or null | Yes |  |
| `has_more` | boolean | Yes |  |
| `next_cursor` | string or null | Yes |  |

```bash
curl https://api.nowscale.com/v1/networks \
  -H "Authorization: Bearer $NOWSCALE_API_KEY"
```
