Dopost API

Dopost is a social media management platform. Its REST API lets you publish and schedule posts, manage media, and inspect connected social accounts.

Base URL: https://dopost.co/api/v1

Auth: All requests require the header x-api-key:

Full docs: https://dopost.co/docs/api

Setup

Always check for an .env or .env.local file with DOPOST_API_KEY. If not present, ask the user for their key before proceeding.

export DOPOST_API_KEY="dpk_live_..."

Endpoints

Social Accounts

List connected accounts

GET /api/v1/social/accounts
Scope: social:accounts

curl -H "x-api-key: $DOPOST_API_KEY" https://dopost.co/api/v1/social/accounts

Returns { accounts: [{ id, platform, platformUsername, platformUserId }] }.

The id field is the accountId needed for publishing.

Get platform limits

GET /api/v1/social/limits/:platform
Scope: social:limits

Platforms: x, instagram, instagram_direct, facebook, linkedin, linkedin_organization, tiktok, youtube, threads, bluesky, mastodon, pinterest

> instagram = connected via Meta Business (Facebook Page linked). instagram_direct = connected directly via Instagram OAuth.

> linkedin = personal profile. linkedin_organization = company page.

curl -H "x-api-key: $DOPOST_API_KEY" https://dopost.co/api/v1/social/limits/instagram

Posts

Publish or schedule a post

POST /api/v1/post/publish
Scope: posts:create

{
  "accountId": "<accountId>",
  "text": "Post content",
  "media": ["https://..."],
  "publishAt": "2025-12-25T12:00:00Z",
  "platformOptions": {}
}

At least text or media is required
media can be an array of URL strings or objects { url: "..." }
Maximum 10 media items per post
Omit publishAt (or set to null) to publish immediately
Returns 202 with { success, jobId, postId, status }
Publishing is asynchronous — poll GET /api/v1/post/:postId to check status

Platform-specific options (`platformOptions`)

Instagram

Field	Values	Default
-------	--------	---------
`postType`	`"feed"` \	`"story"` \	`"reel"`	`"feed"` (auto `"carousel"` with multiple media)

TikTok

Field	Values	Default
-------	--------	---------
`privacyLevel`	`"PUBLIC_TO_EVERYONE"` \	`"MUTUAL_FOLLOW_FRIENDS"` \	`"FOLLOWER_OF_CREATOR"` \	`"SELF_ONLY"`	`"PUBLIC_TO_EVERYONE"`
`disableDuet`	`boolean`	`false`
`disableStitch`	`boolean`	`false`
`disableComment`	`boolean`	`false`

YouTube

Field	Values	Default
-------	--------	---------
`videoType`	`"video"` \	`"short"`	`"video"`
`title`	`string`	First 100 chars of `text`
`privacyStatus`	`"public"` \	`"private"` \	`"unlisted"`	`"public"`

Pinterest

Field	Description
-------	-------------
`board`	Board ID (required for Pinterest)

Get a post

GET /api/v1/post/:postId
Scope: posts:read

Returns the full post object including publish status:

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "INSTAGRAM",
  "text": "Post content",
  "media": [],
  "postUrl": "https://instagram.com/p/...",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": {
    "scheduledFor": "2026-04-13T09:00:00.000Z",
    "status": "PUBLISHED",
    "publishedAt": "2026-04-13T09:00:05.000Z"
  },
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:32:18.000Z"
}

schedule is null for immediate posts. postUrl is null until published.

Use this endpoint to poll status after publishing.

List posts

GET /api/v1/post?status=PENDING&limit=20&cursor=<cursor>
Scope: posts:read

Status filter values: DRAFT, PENDING, PUBLISHED, FAILED

Reschedule a post

PATCH /api/v1/post/:postId
Scope: posts:reschedule
Body: { "publishAt": "2025-12-31T09:00:00Z" }

Only works on posts with status PENDING. The new date must be in the future.

Returns { id, scheduledFor }.

Delete a post

DELETE /api/v1/post/delete/:postId
Scope: posts:delete

Cancels scheduling automatically if the post is PENDING.

Returns { success: true, deletedPostId: "..." }.

Media

Upload media (presigned URL flow)

POST /api/v1/media
Scope: media:upload
Body: { "fileName": "photo.jpg", "contentType": "image/jpeg", "sizeInBytes": 204800 }

Returns 201 with:

{
  "id": "cm3media001xyz",
  "uploadUrl": "https://storage.example.com/...?X-Amz-Signature=...",
  "publicUrl": "https://cdn.dopost.co/media/.../photo.jpg",
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "expiresIn": 3600
}

uploadUrl is a temporary presigned URL — upload the file with a PUT request within expiresIn seconds
publicUrl is the permanent URL — use this as the media URL when publishing
Maximum file size: 1 GB

curl -X PUT -H "Content-Type: image/jpeg" --data-binary @photo.jpg "$UPLOAD_URL"

List media

GET /api/v1/media?limit=20&cursor=<cursor>
Scope: media:list

Delete media

DELETE /api/v1/media/:mediaId
Scope: media:delete

Returns { message: "Media deleted", mediaId: "..." }.

Common workflows

Publish a post now

GET /api/v1/social/accounts — pick accountId
POST /api/v1/post/publish with accountId + text
GET /api/v1/post/:postId — poll until status is PUBLISHED or FAILED

Publish a post with an image

POST /api/v1/media — get uploadUrl + publicUrl
PUT the file to uploadUrl
POST /api/v1/post/publish with media: [publicUrl]
GET /api/v1/post/:postId — poll until published

Schedule and reschedule

Publish with a future publishAt
To change the date: PATCH /api/v1/post/:postId with new publishAt
To cancel: DELETE /api/v1/post/delete/:postId

Error handling

Status	Meaning
--------	---------
`400`	Bad request — check the request body
`401`	Invalid or missing `x-api-key`
`403`	API key lacks the required scope
`404`	Resource not found or inactive account
`429`	Rate limit or monthly quota exceeded. Check `X-RateLimit-*` headers

On 429, respect the Retry-After header before retrying.

Examples

1. List connected accounts

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/social/accounts

Response 200 OK

{
  "accounts": [
    {
      "id": "cm3xyz789ghi012",
      "platform": "INSTAGRAM",
      "platformUsername": "myaccount",
      "platformUserId": "17841400000000001"
    },
    {
      "id": "cm3abc456def789",
      "platform": "LINKEDIN",
      "platformUsername": "johndoe",
      "platformUserId": "urn:li:person:a1B2c3D4e5"
    }
  ]
}

2. Publish a text post immediately

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "Hello from the Dopost API!"
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "postId": "cm3abc123def456",
  "status": "processing"
}

3. Check post status

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/post/cm3abc123def456

Response — published

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "INSTAGRAM",
  "text": "Hello from the Dopost API!",
  "media": [],
  "postUrl": "https://www.instagram.com/p/ABC123/",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:32:18.000Z"
}

Response — failed

{
  "id": "cm3abc123def456",
  "status": "FAILED",
  "platform": "INSTAGRAM",
  "text": "Hello from the Dopost API!",
  "media": [],
  "postUrl": null,
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:05:00.000Z"
}

4. Publish an Instagram Reel

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "New reel! #content",
    "media": ["https://cdn.example.com/video.mp4"],
    "platformOptions": {
      "postType": "reel"
    }
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "a1b2c3d4-0000-4abc-8def-111122223333",
  "postId": "cm3reel001xyz",
  "status": "processing"
}

5. Schedule a post

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3abc456def789",
    "text": "Scheduled post for next Monday!",
    "publishAt": "2026-04-13T09:00:00Z"
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "b2c3d4e5-1111-4bcd-9ef0-222233334444",
  "postId": "cm3sched001abc",
  "status": "scheduled"
}

6. Upload media and publish with it

Step 1 — Request presigned URL

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "photo.jpg",
    "contentType": "image/jpeg",
    "sizeInBytes": 204800
  }' \
  https://dopost.co/api/v1/media

Response 201 Created

{
  "id": "cm3media001xyz",
  "uploadUrl": "https://storage.example.com/uploads/photo.jpg?X-Amz-Signature=...",
  "publicUrl": "https://cdn.dopost.co/media/cm3media001xyz/photo.jpg",
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "expiresIn": 3600
}

Step 2 — Upload the file

curl -X PUT \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg \
  "https://storage.example.com/uploads/photo.jpg?X-Amz-Signature=..."

Returns 200 with empty body on success.

Step 3 — Publish using the public URL

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "Check out this photo!",
    "media": ["https://cdn.dopost.co/media/cm3media001xyz/photo.jpg"]
  }' \
  https://dopost.co/api/v1/post/publish

7. Reschedule a pending post

Request

curl -X PATCH \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "publishAt": "2026-04-20T14:00:00Z" }' \
  https://dopost.co/api/v1/post/cm3sched001abc

Response 200 OK

{
  "id": "cm3sched001abc",
  "scheduledFor": "2026-04-20T14:00:00.000Z"
}

8. List posts with filter

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  "https://dopost.co/api/v1/post?status=PUBLISHED&limit=5"

Response 200 OK

{
  "posts": [
    {
      "id": "cm3abc123def456",
      "status": "PUBLISHED",
      "text": "Hello from the Dopost API!",
      "publishedAt": "2026-04-07T10:32:18.000Z",
      "account": {
        "id": "cm3xyz789ghi012",
        "platform": "INSTAGRAM",
        "platformUsername": "myaccount"
      }
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

9. Delete a post

Request

curl -X DELETE \
  -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/post/delete/cm3sched001abc

Response 200 OK

{
  "success": true,
  "deletedPostId": "cm3sched001abc"
}

MCP server (optional)

If the user has the Dopost MCP server configured, prefer using MCP tools (publish_post, list_accounts, etc.) over raw HTTP calls — they handle auth and path safety automatically.

MCP setup: https://dopost.co/docs/api

dopost-api

概述

Dopost API

Setup

Endpoints

Social Accounts

List connected accounts

Get platform limits

Posts

Publish or schedule a post

Platform-specific options (`platformOptions`)

Get a post

List posts

Reschedule a post

Delete a post

Media

Upload media (presigned URL flow)

List media

Delete media

Common workflows

Publish a post now

Publish a post with an image

Schedule and reschedule

Error handling

Examples

1. List connected accounts

2. Publish a text post immediately

3. Check post status

4. Publish an Instagram Reel

5. Schedule a post

6. Upload media and publish with it

7. Reschedule a pending post

8. List posts with filter

9. Delete a post

MCP server (optional)

版本历史

安全检测

dopost-api

概述

Dopost API

Setup

Endpoints

Social Accounts

List connected accounts

Get platform limits

Posts

Publish or schedule a post

Platform-specific options (platformOptions)

Get a post

List posts

Reschedule a post

Delete a post

Media

Upload media (presigned URL flow)

List media

Delete media

Common workflows

Publish a post now

Publish a post with an image

Schedule and reschedule

Error handling

Examples

1. List connected accounts

2. Publish a text post immediately

3. Check post status

4. Publish an Instagram Reel

5. Schedule a post

6. Upload media and publish with it

7. Reschedule a pending post

8. List posts with filter

9. Delete a post

MCP server (optional)

版本历史

安全检测

Platform-specific options (`platformOptions`)