API Documentation

GET /v1/reddit/feed

Query params:

• accountId: required. Your connected Reddit account ID.
• subreddit: optional. e.g. r/reactjs or reactjs. If omitted, shows a global feed.
• sort: optional. hot (default) | new | top | rising.
• limit: optional. 1-100 (default 25).
• after: optional. Pagination token.
• t: optional. Only for top: hour|day|week|month|year|all.

curl "https://getlate.dev/api/v1/reddit/feed?accountId=ACCOUNT_ID&subreddit=r/reactjs&sort=hot&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "items": [
    {
      "id": "abc123",
      "fullname": "t3_abc123",
      "title": "Interesting discussion",
      "author": "example_user",
      "subreddit": "reactjs",
      "url": "https://example.com",
      "permalink": "https://www.reddit.com/r/reactjs/comments/abc123/...",
      "selftext": "...",
      "createdUtc": 1700000000,
      "score": 123,
      "numComments": 45,
      "over18": false,
      "stickied": false,
      "flairText": null
    }
  ],
  "after": "t3_def456",
  "before": null
}

GET /v1/reddit/search

Query params:

• accountId: required. Your connected Reddit account ID.
• q: required. Search query.
• subreddit: optional. e.g. r/technology or technology.
• restrict_sr: optional. 1/0. Defaults to 1 if subreddit provided.
• sort: optional. relevance|hot|top|new|comments (default new).
• limit: optional. 1-100 (default 25).
• after: optional. Pagination token.

curl "https://getlate.dev/api/v1/reddit/search?accountId=ACCOUNT_ID&subreddit=r/technology&q=AI&sort=new&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "items": [
    {
      "id": "ghi789",
      "fullname": "t3_ghi789",
      "title": "AI is transforming workflows",
      "author": "another_user",
      "subreddit": "technology",
      "url": "https://example.com",
      "permalink": "https://www.reddit.com/r/technology/comments/ghi789/...",
      "selftext": "...",
      "createdUtc": 1700000001,
      "score": 98,
      "numComments": 12,
      "over18": false,
      "stickied": false,
      "flairText": null
    }
  ],
  "after": null,
  "before": null
}

GET /v1/accounts/[accountId]/reddit-subreddits

Returns subreddits you can post to from this account and the current default (if any).

{
  "subreddits": [
    { "name": "programming", "display_name_prefixed": "r/programming" },
    { "name": "reactjs", "display_name_prefixed": "r/reactjs" }
  ],
  "defaultSubreddit": "programming"
}

PUT /v1/accounts/[accountId]/reddit-subreddits

Set the default subreddit used when a post doesn't specify one.

{
  "defaultSubreddit": "reactjs"
}

GET /v1/accounts/[accountId]/pinterest-boards

List boards for a connected Pinterest account and the configured default.

{
  "boards": [
    { "id": "123", "name": "Inspiration" },
    { "id": "456", "name": "Engineering" }
  ],
  "defaultBoardId": "123"
}

PUT /v1/accounts/[accountId]/pinterest-boards

Set a default board for posts that do not include platformSpecificData.boardId.

{
  "defaultBoardId": "123",
  "defaultBoardName": "Inspiration"
}

Reset Schedule

• Monthly Plans: Usage resets on your signup anniversary day each month
• Annual Plans: Usage resets on your signup anniversary date each year
• Free Users: Automatic reset based on signup date
• Paid Users: Reset triggered by Stripe billing webhooks

What's Tracked

• Uploads: Each successful post creation (drafts don't count) - resets with billing cycle
• Profiles: Total number of profiles you currently have - decreases when you delete profiles
• Last Reset: Timestamp of your last usage reset (uploads only)

Upload Limit Exceeded

{
  "error": "Post limit reached. Your Free plan allows 10 posts per month. You have used 10.",
  "planName": "Free",
  "limit": 10,
  "current": 10,
  "billingPeriod": "monthly"
}

Profile Limit Exceeded

{
  "error": "Profile limit reached. Your basic plan allows 10 profiles. You currently have 10.",
  "planName": "basic",
  "limit": 10,
  "current": 10,
  "details": {
    "resource": "profiles",
    "plan": "basic",
    "currentUsage": 10,
    "limit": 10,
    "window": "total"
  }
}

1. Create a Profile

2. Connect Social Accounts

3. Schedule a Post

GET /v1/profiles

Get all profiles for your account.

Response

{
  "profiles": [
    {
      "_id": "profile_id",
      "name": "Personal Brand",
      "description": "My personal accounts", 
      "color": "#ffeda0",
      "isDefault": true,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ]
}

POST /v1/profiles

Create a new profile. Subject to plan limits.

Request Body

{
  "name": "Business Account",
  "description": "Company social media",
  "color": "#4ade80"
}

Response Status Codes

• 201 - Profile created successfully
• 400 - Invalid request data or profile name already exists
• 401 - Invalid API key
• 403 - Profile limit reached for your plan
• 404 - User not found

PUT /v1/profiles/[profileId]

Update an existing profile.

DELETE /v1/profiles/[profileId]

Delete a profile. Cannot delete profiles with connected accounts.

GET /v1/usage-stats

Get current usage statistics for your account.

Response

{
  "planName": "Accelerate",
  "billingPeriod": "yearly",
  "limits": {
    "uploads": -1,
    "profiles": 50,

  },
  "usage": {
    "uploads": 847,
    "profiles": 12,
    "lastReset": "2024-01-01T00:00:00.000Z"
  },
  "canUpload": true,
  "canCreateProfile": true
}

Response Fields

• limits.uploads - Upload limit (-1 = unlimited)
• limits.profiles - Profile limit
• usage.uploads - Current period uploads
• usage.profiles - Total profiles created
• canUpload - Whether you can create more posts
• canCreateProfile - Whether you can create more profiles

GET /v1/posts

Retrieve a list of your scheduled and published posts with pagination.

Query Parameters

• page - Page number (default: 1)
• limit - Posts per page (default: 10, max: 100)
• status - Filter by status (draft, scheduled, published, failed)
• platform - Filter by platform
• profileId - Filter by a specific profile
• createdBy - Filter by creator user ID
• dateFrom - ISO datetime inclusive lower bound
• dateTo - ISO datetime inclusive upper bound
• includeHidden - Include hidden posts (default: false)

POST /v1/posts

Create and schedule a new post across multiple social media platforms. Subject to upload limits.

{
  "content": "Tweet 1 — intro",
  "scheduledFor": "2024-01-01T12:00:00",
  "timezone": "UTC",
  "platforms": [
    {
      "platform": "twitter",
      "accountId": "TWITTER_ACCOUNT_ID",
      "platformSpecificData": {
        "threadItems": [
          { "content": "Tweet 1 — intro", "mediaItems": [{ "type": "image", "url": "https://.../img.jpg" }] },
          { "content": "Tweet 2 — details" },
          { "content": "Tweet 3 — CTA" }
        ]
      }
    }
  ]
}

{
  "content": "Post 1 — intro",
  "scheduledFor": "2024-01-01T12:00:00",
  "timezone": "UTC",
  "platforms": [
    {
      "platform": "threads",
      "accountId": "THREADS_ACCOUNT_ID",
      "platformSpecificData": {
        "threadItems": [
          { "content": "Post 1 — intro", "mediaItems": [{ "type": "image", "url": "https://.../img.jpg" }] },
          { "content": "Post 2 — details" },
          { "content": "Post 3 — CTA" }
        ]
      }
    }
  ]
}

{
  "content": "Post 1 — intro",
  "scheduledFor": "2024-01-01T12:00:00",
  "timezone": "UTC",
  "platforms": [
    {
      "platform": "bluesky",
      "accountId": "BLUESKY_ACCOUNT_ID",
      "platformSpecificData": {
        "threadItems": [
          { "content": "Post 1 — intro", "mediaItems": [{ "type": "image", "url": "https://.../img.jpg" }] },
          { "content": "Post 2 — details" },
          { "content": "Post 3 — CTA" }
        ]
      }
    }
  ]
}

{
  "content": "New feature live today!",
  "platforms": [
    {
      "platform": "facebook",
      "accountId": "FACEBOOK_ACCOUNT_ID",
      "platformSpecificData": {
        "firstComment": "Read more here: https://example.com 🚀"
      }
    }
  ]
}

Request Body

{
  "content": "Your post content here",
  "platforms": [
    {"platform": "twitter", "accountId": "TWITTER_ACCOUNT_ID"},
    {"platform": "instagram", "accountId": "INSTAGRAM_ACCOUNT_ID"},
    {"platform": "linkedin", "accountId": "LINKEDIN_ACCOUNT_ID"},
    {"platform": "threads", "accountId": "THREADS_ACCOUNT_ID"},
    {"platform": "youtube", "accountId": "YOUTUBE_ACCOUNT_ID"}
  ],
  "scheduledFor": "2024-01-01T12:00:00",
  "timezone": "America/New_York",
  "publishNow": false,
  "isDraft": false,
  "visibility": "public|private|unlisted",
  "tags": ["programming", "tutorial", "api", "coding"],
  "mediaItems": [
    {
      "type": "image|video|gif|document",
      "url": "media_url_from_/v1/media",
      "filename": "optional_filename"
    }
  ]
}

{
  "content": "Our new product brochure",
  "platforms": [
    { "platform": "linkedin", "accountId": "LINKEDIN_ACCOUNT_ID" }
  ],
  "mediaItems": [
    {
      "type": "document",
      "url": "https://.../brochure.pdf",
      "filename": "brochure.pdf",
      "mimeType": "application/pdf"
    }
  ]
}

{
  "post": {
    "platforms": [
      {
        "platform": "instagram",
        "platformPostUrl": "https://www.instagram.com/p/XXXXXXXX/"
      }
    ]
  }
}

Response Status Codes

• 201 - Post published successfully to all platforms
• 207 - Multi-Status: Some platforms succeeded, others failed
• 400 - Invalid request data
• 401 - Invalid API key

POST /v1/posts/bulk-upload

Upload a CSV to validate and schedule multiple posts at once. Supports a dry-run mode for validation without creating posts.

curl -X POST https://getlate.dev/api/v1/posts/bulk-upload?dryRun=true \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/absolute/path/to/bulk.csv;type=text/csv"

curl -X POST https://getlate.dev/api/v1/posts/bulk-upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/absolute/path/to/bulk.csv;type=text/csv"

{
  "total": 12,
  "valid": 10,
  "invalid": 2,
  "results": [
    { "rowIndex": 1, "ok": true, "createdPostId": "66..." },
    { "rowIndex": 2, "ok": false, "errors": ["profiles_missing"] }
  ],
  "warnings": []
}

GET /v1/posts/[postId]

Get details of a specific post by ID.

PUT /v1/posts/[postId]

Update a post. Only draft and scheduled posts can be edited.

Request Body

Same structure as POST /v1/posts, all fields are optional:

{
  "content": "Updated post content",
  "scheduledFor": "2024-01-01T15:00:00",
  "timezone": "America/New_York",
  "platforms": [
    {"platform": "twitter", "accountId": "TWITTER_ACCOUNT_ID"},
    {"platform": "linkedin", "accountId": "LINKEDIN_ACCOUNT_ID"},
    {"platform": "threads", "accountId": "THREADS_ACCOUNT_ID"},
    {"platform": "youtube", "accountId": "YOUTUBE_ACCOUNT_ID"}
  ],
  "tags": ["updated", "tutorial", "new"],
  "isDraft": false,
  "publishNow": false,
  "mediaItems": [...]
}

DELETE /v1/posts/[postId]

Delete a post. Published posts cannot be deleted. All other statuses (draft, scheduled, publishing, failed, cancelled) can be deleted.

POST /v1/posts/[postId]/retry

Retry publishing a failed post. Only failed posts can be retried.

POST /v1/media

Upload media files (images/videos) for use in posts. Supports files up to 5GB. Note: large files use a JSON client-upload flow; raw multipart uploads may hit platform body-size limits.

File Upload — small files via multipart

Large files — client-upload flow (up to 5GB)

import { upload } from '@vercel/blob/client';
import fs from 'node:fs';

const apiKey = process.env.Late_API_KEY;
if (!apiKey) { console.error('Missing Late_API_KEY'); process.exit(1); }

const filepath = process.argv[2];
if (!filepath) { console.error('Usage: node upload-large.mjs <path-to-file>'); process.exit(1); }

const data = fs.readFileSync(filepath);
const filename = filepath.split('/').pop() || 'file.bin';

const res = await upload(filename, data, {
  access: 'public',
  handleUploadUrl: 'https://getlate.dev/api/v1/media',
  headers: { Authorization: 'Bearer ' + apiKey },
  multipart: true,
  // set a valid type for your file
  contentType: filename.endsWith('.mp4') ? 'video/mp4' : 'image/jpeg'
});

console.log('Uploaded to:', res.url);

# Install
npm i @vercel/blob

# Set API key
export Late_API_KEY=YOUR_API_KEY

# Upload large file via token flow
node -e "import fs from 'node:fs';import('@vercel/blob/client').then(async ({upload})=>{const data=fs.readFileSync('path/to/large.mp4');const res=await upload('large.mp4',data,{access:'public',handleUploadUrl:'https://getlate.dev/api/v1/media',headers:{Authorization:'Bearer '+process.env.Late_API_KEY},multipart:true,contentType:'video/mp4'});console.log(res.url);}).catch(e=>{console.error(e);process.exit(1);})"

GET /v1/accounts

Get connected social media accounts, optionally filtered by profile.

Query Parameters

• profileId - Filter accounts by profile ID (optional)

Response

{
  "accounts": [
    {
      "_id": "account_id",
      "profileId": "profile_id",
      "platform": "instagram",
      "username": "your_username",
      "displayName": "Your Display Name",
      "profilePicture": "https://...",
      "isActive": true,
      "tokenExpiresAt": "2024-12-31T23:59:59Z",
      "permissions": ["posts:write", "posts:read"]
    }
  ]
}

GET /v1/connect/[platform]

Initiate OAuth connection for a platform to a specific profile.

Query Parameters

• profileId - Profile ID to connect the account to (required)
• redirect_url - Custom URL to redirect to after OAuth completion (optional)

Custom Redirects

By default, users are redirected to the dashboard after connecting an account. Use redirect_url to redirect to your own application instead.

DELETE /v1/accounts/[accountId]

Disconnect a social media account from its profile.

POST /v1/profiles/[profileId]/clone-connection

Import an existing connection from another profile to the target profile. Useful for reusing OAuth tokens while targeting different pages or organizations. Supports both API key and session authentication.

Request Body

{
  "sourceAccountId": "source_account_id_123",
  "targetPageId": "facebook_page_id_456",
  "targetPageName": "Target Facebook Page",
  "targetPageAccessToken": "page_access_token...",
  "targetOrganizationId": "linkedin_org_id_789",
  "targetOrganizationUrn": "urn:li:organization:789",
  "targetOrganizationName": "Target LinkedIn Company",
  "targetAccountType": "organization"
}

Parameters

• sourceAccountId - ID of existing connection to clone (required)
• targetPageId - Facebook page ID to target (optional, for Facebook)
• targetPageName - Facebook page name (optional, for Facebook)
• targetPageAccessToken - Facebook page access token (optional, for Facebook)
• targetOrganizationId - LinkedIn organization ID (optional, for LinkedIn)
• targetOrganizationUrn - LinkedIn organization URN (optional, for LinkedIn)
• targetOrganizationName - LinkedIn organization name (optional, for LinkedIn)
• targetAccountType - "personal" or "organization" (optional, for LinkedIn)

Response

{
  "message": "Connection cloned successfully",
  "connection": {
    "_id": "new_connection_id",
    "platform": "facebook",
    "username": "Target Facebook Page",
    "displayName": "Target Facebook Page",
    "isActive": true,
    "profileId": "target_profile_id"
  }
}

Use Cases

GET /v1/connect/facebook/select-page

Get available Facebook pages for selection during connection process.

Query Parameters

• profileId - Profile ID to connect the page to (required)
• tempToken - Temporary OAuth token from Facebook (required)

Response

{
  "pages": [
    {
      "id": "page_id_123",
      "name": "My Business Page",
      "access_token": "page_access_token_...",
      "category": "Business",
      "tasks": ["MANAGE", "CREATE_CONTENT"]
    }
  ]
}

POST /v1/connect/facebook/select-page

Connect a specific Facebook page to a profile.

Request Body

{
  "profileId": "profile_id_123",
  "pageId": "page_id_456",
  "tempToken": "facebook_temp_token...",
  "userProfile": {
    "id": "user_facebook_id",
    "name": "User Name",
    "profilePicture": "https://..."
  }
}

Response

{
  "message": "Facebook page connected successfully",
  "account": {
    "platform": "facebook",
    "username": "My Business Page",
    "displayName": "My Business Page",
    "isActive": true,
    "selectedPageName": "My Business Page"
  }
}

PUT /v1/accounts/[accountId]/facebook-page

Update which Facebook page an existing account should post to.

Request Body

{
  "selectedPageId": "new_page_id_789"
}

Instagram Content Types

{
  "content": "Your post caption here",
  "platforms": [
    {"platform": "instagram", "accountId": "INSTAGRAM_ACCOUNT_ID"}
  ],
  "mediaItems": [
    {
      "type": "image",
      "url": "image_url_1"
    },
    {
      "type": "image", 
      "url": "image_url_2"
    }
  ]
}

{
  "content": "Optional story caption",
  "platforms": [
    {"platform": "instagram", "accountId": "INSTAGRAM_ACCOUNT_ID", "platformSpecificData": {"contentType": "story"}}
  ],
  "mediaItems": [
    {
      "type": "image",
      "url": "image_url_1"
    }
  ]
}

{
  "content": "Check out this amazing reel! 🎥",
  "platforms": [
    {"platform": "instagram", "accountId": "INSTAGRAM_ACCOUNT_ID"}
  ],
  "mediaItems": [
    {
      "type": "video",
      "url": "video_url",
      "instagramThumbnail": "thumbnail_image_url"
    }
  ]
}

{
  "content": "Amazing collaboration post! 🤝",
  "platforms": [
    {
      "platform": "instagram", 
      "accountId": "INSTAGRAM_ACCOUNT_ID",
      "platformSpecificData": {
        "collaborators": ["username1", "username2", "username3"]
      }
    }
  ],
  "mediaItems": [
    {
      "type": "image",
      "url": "https://your-image-url.jpg"
    }
  ]
}

TikTok Direct Posting

{
  "content": "My new video 🎥🔥",
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "TIKTOK_ACCOUNT_ID",
      "platformSpecificData": {
        "tiktokSettings": {
          "privacy_level": "PUBLIC_TO_EVERYONE",
          "video_made_with_ai": true,
          "allow_comment": true,
          "allow_duet": true,
          "allow_stitch": true,
          "commercial_content_type": "none",
          "content_preview_confirmed": true,
          "express_consent_given": true
        }
      }
    }
  ],
  "mediaItems": [
    { "type": "video", "url": "https://.../video.mp4" }
  ],
  "scheduledFor": null,
  "timezone": "UTC"
}

YouTube Content Types

{
  "content": "Amazing tutorial on building APIs! Check it out 🚀",
  "tags": ["programming", "tutorial", "api", "coding", "javascript"],
  "platforms": [
    {
      "platform": "youtube", 
      "accountId": "YOUTUBE_ACCOUNT_ID",
      "platformSpecificData": {
        "firstComment": "Thanks for watching! What did you think? Don't forget to like and subscribe! 🎥"
      }
    }
  ],
  "mediaItems": [
    {
      "type": "video",
      "url": "https://your-video-url.mp4",
      "thumbnail": "https://your-custom-thumbnail.jpg"
    }
  ],
  "scheduledFor": "2024-01-15T16:00:00Z"
}

{
  "content": "Check out this amazing short! #Shorts 🔥",
  "tags": ["shorts", "viral", "trending", "quick"],
  "platforms": [
    {
      "platform": "youtube", 
      "accountId": "YOUTUBE_ACCOUNT_ID",
      "platformSpecificData": {
        "title": "Amazing Short Video That Will Blow Your Mind! 🔥",
        "firstComment": "Did you enjoy this Short? Let me know in the comments! 💥"
      }
    }
  ],
  "mediaItems": [
    {
      "type": "video",
      "url": "https://your-vertical-video.mp4"
    }
  ],
  "scheduledFor": "2024-01-15T16:00:00Z"
}