API Reference

Landio API

A REST API for scripting and integrating with your workspace directly — the same operations available in the app, callable from anywhere.

Authentication

Create an API key from Settings → API keys in your workspace. Every request needs it as a bearer token:

Authorization: Bearer landio_...

A key acts with the same permissions as the account that created it — the same role-based access control the web app itself enforces applies to every API request too. Revoke a key at any time from the same Settings page.

Response format

Successful responses are JSON, wrapped in a top-level data field. Errors return a 4xx status with { "error": "...", "error_description": "..." }.

Endpoints

GET/api/v1/accounts

List every social account connected to your workspace.

Example

curl https://your-domain.com/api/v1/accounts \
  -H "Authorization: Bearer landio_..."

GET/api/v1/content

List posts, newest first. Supports ?status= and ?page= query params.

Example

curl "https://your-domain.com/api/v1/content?status=DRAFT&page=1" \
  -H "Authorization: Bearer landio_..."

POST/api/v1/content

Create a new draft post targeting one or more connected accounts.

Request body

{
  "title": "Spring sale announcement",
  "brief": "Announce our 20% spring sale, ends Sunday",
  "objective": "SALES",
  "tone": "PROMOTIONAL",
  "format": "POST",
  "socialAccountIds": ["<account-id>"]
}

Example

curl -X POST https://your-domain.com/api/v1/content \
  -H "Authorization: Bearer landio_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Spring sale","brief":"Announce our 20% spring sale","objective":"SALES","tone":"PROMOTIONAL","format":"POST","socialAccountIds":["<account-id>"]}'

GET/api/v1/content/:id

Get one post's full detail, including every platform variant and its status.

Example

curl https://your-domain.com/api/v1/content/<content-id> \
  -H "Authorization: Bearer landio_..."

POST/api/v1/variants/:id/schedule

Schedule one platform variant to publish at a specific future time.

Request body

{ "scheduledAt": "2026-09-20T14:00:00Z" }

Example

curl -X POST https://your-domain.com/api/v1/variants/<variant-id>/schedule \
  -H "Authorization: Bearer landio_..." \
  -H "Content-Type: application/json" \
  -d '{"scheduledAt":"2026-09-20T14:00:00Z"}'

POST/api/v1/variants/:id/publish

Publish one platform variant immediately — this goes live right away, no undo.

Example

curl -X POST https://your-domain.com/api/v1/variants/<variant-id>/publish \
  -H "Authorization: Bearer landio_..."

GET/api/v1/analytics

Workspace-wide performance: totals, top content, and per-platform breakdown.

Example

curl https://your-domain.com/api/v1/analytics \
  -H "Authorization: Bearer landio_..."

Don't have a workspace yet?

Create a free account, connect an account, and generate your first API key in minutes.

Get Started Free