# API reference

> All 79 routes of the Praeko API in 18 resources: parameters, body, examples in 10 languages, responses and errors for each one.

Source: https://praeko.app/docs/en/api

All 79 routes of the v1 contract, generated from the same file as [openapi.json](https://praeko.app/openapi.json). Each page shows the minimum key scope, the parameters, the body with a ready-to-use example, code in 10 languages, an example response and the errors.

> **On every request** Base URL `https://praeko.app`. Headers `Authorization: Bearer praeko_…` and `X-Praeko-Contract: en`. See [authentication and scopes](https://praeko.app/docs/en/auth).

## Resources

| Resource | Routes | What it covers |
|---|---|---|
| [Health](https://praeko.app/docs/en/api/health) | 2 | Service health, Service health (versioned path) |
| [Connections](https://praeko.app/docs/en/api/connections) | 4 | OAuth callback, Start network connection, Disconnect network… |
| [Media](https://praeko.app/docs/en/api/media) | 11 | Public media by token, Public media by token, Create media… |
| [Channels](https://praeko.app/docs/en/api/channels) | 8 | List channels, Set default channel, Remove channel… |
| [TikTok](https://praeko.app/docs/en/api/tiktok) | 1 | TikTok creator info |
| [Posts](https://praeko.app/docs/en/api/posts) | 9 | Create post, Adopt scheduled post, List posts… |
| [Calendar](https://praeko.app/docs/en/api/calendar) | 1 | Calendar |
| [Insights](https://praeko.app/docs/en/api/insights) | 4 | Metrics, Retention, impressions and CTR, Post retention… |
| [Content](https://praeko.app/docs/en/api/content) | 1 | Published content |
| [YouTube](https://praeko.app/docs/en/api/youtube) | 7 | YouTube videos, Get YouTube video, Update YouTube video… |
| [Instagram](https://praeko.app/docs/en/api/instagram) | 6 | Instagram media, Instagram comments, Reply to Instagram comment… |
| [Comments](https://praeko.app/docs/en/api/comments) | 2 | Comments from all networks, Mentions |
| [API keys](https://praeko.app/docs/en/api/api-keys) | 3 | List API keys, Create API key, Revoke API key |
| [Usage and log](https://praeko.app/docs/en/api/usage-and-log) | 2 | Usage summary, Request log |
| [Preferences](https://praeko.app/docs/en/api/preferences) | 2 | Get preferences, Save preferences |
| [Notifications](https://praeko.app/docs/en/api/notifications) | 2 | List notifications, Mark notifications as read |
| [Webhooks](https://praeko.app/docs/en/api/webhooks) | 9 | List webhooks, Create webhook, Get webhook… |
| [Ideas](https://praeko.app/docs/en/api/ideas) | 5 | List ideas, Create idea, Import ideas… |

## For your client generator

The [openapi.json](https://praeko.app/openapi.json) file (OpenAPI 3.1) carries the same contract. In the panel's documentation screen (after you sign in) you can also download the Postman collection.