# Govir API

**Canonical:** https://apis.io/apis/govir-app/govir-app-api/  
**Provider:** Govir — https://apis.io/providers/govir-app/  
**Documentation:** https://govir.app/docs/api

Govir API is one of 2 APIs that [Govir](https://apis.io/providers/govir-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Govir API as documented publicly: 28 operations. Contract generated from the documentation by API Evangelist (2026-11-10); not the provider's own document.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts` | the connected accounts. |
| GET | `/accounts/{id}/metrics` | GET /accounts/{id}/metrics (read): an account's overview for a period: posts, views, likes, replies, reposts and quotes, interactions, engagement rate and li... |
| GET | `/accounts/{id}/metrics/posts` | GET /accounts/{id}/metrics/posts (read): the account's posts by what they gained in the period. |
| GET | `/api/v1/me` | GET /api/v1/me |
| GET | `/api/v1/media/from-url` | POST /media/from-url (write): Govir fetches the file at a public http or https link and prepares it like an upload. |
| POST | `/api/v1/media/from-url` | POST /api/v1/media/from-url |
| GET | `/api/v1/posts` | Posts (read): posts, newest first. |
| POST | `/api/v1/posts` | POST /api/v1/posts |
| GET | `/gifs` | GET /gifs (write): GIPHY GIFs to attach, trending or a search with q (up to 50 characters). |
| GET | `/me` | the key's workspace, plan and scopes, and whether publishing right away is allowed. |
| GET | `/media` | GET /media (write): images and videos already in your workspace, newest first. |
| POST | `/media` | initiate a file upload. |
| POST | `/media/from-url` | POST /media/from-url (write): Govir fetches the file at a public http or https link and prepares it like an upload. |
| POST | `/media/stock` | POST /media/stock (write) brings the chosen one into your media. |
| POST | `/media/upload-links` | POST /media/upload-links (write): a one-time page where you add files from your device. |
| GET | `/media/upload-links/{id}` | GET /media/upload-links/{id} returns status: "done" and the files in media. |
| GET | `/media/{id}` | Images are ready at once; videos are processed, so follow them with GET /media/{id} until status is ready. |
| POST | `/media/{id}/complete` | finalize an upload after the file bytes have been sent. |
| GET | `/posts` | posts, newest first. |
| POST | `/posts` | a new draft. |
| DELETE | `/posts/{id}` | delete a draft or a scheduled post. |
| GET | `/posts/{id}` | one post with its parts and media. |
| PATCH | `/posts/{id}` | change a draft. |
| GET | `/posts/{id}/metrics` | GET /posts/{id}/metrics (read): a published post's totals and how they grew (history, with hours since publishing). |
| POST | `/posts/{id}/publish` | publish now. |
| POST | `/posts/{id}/schedule` | schedule the post at a time, or in the next free slot of your queue. |
| POST | `/posts/{id}/unschedule` | back to drafts. |
| GET | `/stock-photos` | GET /stock-photos (write): free photos from Pexels and Pixabay. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/govir-app/openapi/_ae-authored/govir-app-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/govir-app/json-schema/govir-app-get-api-v1-media-from-url-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/govir-app/json-schema/govir-app-post-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/govir-app/json-schema/govir-app-post-api-v1-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/govir-app/json-schema/govir-app-get-posts-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/govir-app/json-schema/govir-app-post-media-from-url-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/govir-app/json-schema/govir-app-patch-posts-id-request-schema.json

## Other Govir APIs (1)

- [Govir API](https://apis.io/apis/govir-app/govir-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/govir-app/govir-app-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/govir-app/.