Public API

REST API Reference for social media posting

Public API Reference

The ReplyNodes Public API provides a comprehensive RESTful interface for automating social media workflows, managing integrations, and scheduling posts across 28+ channels.

Base URL

All API requests should be made to:

https://api.replynodes.com/public/v1

Authentication

The API supports two authentication methods:

API Key Authentication

Include your API key in the Authorization header:

curl -H "Authorization: YOUR_API_KEY" \
  https://api.replynodes.com/public/v1/posts

You can rotate your API key through Settings → Public API → Access in the ReplyNodes dashboard.

OAuth App Authentication

OAuth app tokens are prefixed with pos_ and work identically to API keys:

curl -H "Authorization: pos_your_oauth_token" \
  https://api.replynodes.com/public/v1/posts

Learn more about OAuth apps in the OAuth Applications guide.

Core Endpoints

Posts

• GET /posts - List posts with filtering
• POST /posts - Create a new post
• GET /posts/:id - Retrieve a specific post
• DELETE /posts/:id - Delete a post
• DELETE /posts/group/:group - Delete all posts in a group
• PUT /posts/:id/status - Change post status (draft, scheduled, published)
• PUT /posts/:id/release-id - Update post release ID
• GET /posts/:id/missing - Get missing content requirements

Integrations

• GET /integrations - List connected integrations
• GET /integrations?group=:groupId - Filter integrations by group
• DELETE /integrations/:id - Disconnect an integration
• GET /integration-settings/:id - Get validation rules and max length

Media & Files

• POST /upload - Upload media file (form-data)
• POST /upload-from-url - Upload media from URL

Supported formats: JPEG, PNG, GIF, WebP, AVIF, BMP, TIFF, MP4

Social Connections

• GET /social/:integration - Generate authentication URL for integration
• GET /is-connected - Check API connectivity

Groups & Organization

• GET /groups - List all integration groups (channels)

Analytics

• GET /analytics/:integration - Get analytics for an integration
• GET /analytics/post/:postId - Get post-specific analytics

Notifications

• GET /notifications - List notifications with pagination

Media Generation

• POST /generate-video - Generate AI video
• POST /video/function - Call video functions

Utilities

• GET /find-slot/:id - Find optimal posting time for an integration
• POST /integration-trigger/:id - Execute integration-specific tools

Response Format

All responses are JSON. Successful requests return a 200 status with the requested data:

{
  "posts": [
    {
      "id": "post-123",
      "content": "Hello world!",
      "status": "scheduled",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ]
}

Error Handling

Errors include an appropriate HTTP status code and error message:

{
  "msg": "Post not found"
}

Common status codes:

• 400 - Bad Request (invalid parameters)
• 401 - Unauthorized (invalid API key)
• 404 - Not Found (resource doesn't exist)
• 500 - Server Error

Rate Limiting

The API is rate-limited based on your plan. Include the X-RateLimit-Remaining header in responses to track your quota.

Quick Start

1. Get Your API Key

1. Sign in to ReplyNodes
2. Go to Settings → Public API → Access
3. Copy your API key

2. Create a Post

curl -X POST https://api.replynodes.com/public/v1/posts \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "posts": [
      {
        "value": [
          {
            "text": "Hello ReplyNodes!"
          }
        ],
        "integrations": ["twitter", "linkedin"]
      }
    ]
  }'

3. List Posts

curl https://api.replynodes.com/public/v1/posts \
  -H "Authorization: YOUR_API_KEY"

Next Steps

• OAuth Applications - Build apps that act on behalf of users
• Node.js SDK - Use the official SDK
• CLI Tool - Command-line interface