Repliz API Skill

Prerequisites & Setup

Before using this skill, you must complete the following setup steps:

1. Register/Login to Repliz

• Register: Visit https://repliz.com/register to create a new account
• Login: Visit https://repliz.com/login to sign in to your existing account

2. Connect Social Media Accounts

After logging in, connect your social media accounts:

• Go to your Repliz dashboard
• Add and connect accounts like Instagram, Threads, TikTok, Facebook, LinkedIn, or YouTube
• Ensure the accounts show as "connected" before proceeding

3. Obtain API Credentials

To get your Access Key and Secret Key for Basic Authentication:

1. Navigate to https://repliz.com/user/setting/api
2. Generate or copy your Access Key and Secret Key
3. Store these credentials securely - they grant access to post, delete, and manage your social media content

4. Configure Environment Variables

This skill requires the following environment variables to be set:

export REPLIZ_ACCESS_KEY="your-access-key-here"
export REPLIZ_SECRET_KEY="your-secret-key-here"

## Authentication

All API requests require **Basic Authentication** in the header:
- **Username**: $REPLIZ_ACCESS_KEY
- **Password**: $REPLIZ_SECRET_KEY
- **Base URL**: `https://api.repliz.com`

## API Endpoints

### Accounts

**GET /public/account**
- Query params: `page` (default 1), `limit` (default 10), `search` (optional)
- Returns list of connected social media accounts
- Fields: `_id`, `generatedId`, `name`, `username`, `picture`, `isConnected`, `type` (instagram/threads/tiktok/etc), `userId`, `createdAt`, `updatedAt`

**GET /public/account/{_id}**
- Get account details by ID (use `_id` field from account list)
- Returns full account info including `token.access` for posting

---

### Schedules

**GET /public/schedule**
- Query params: `page`, `limit`, `accountIds` (can be repeated)
- Returns scheduled posts

**GET /public/schedule/{_id}**
- Get schedule details by ID

**POST /public/schedule**
- Create new scheduled post. Request body varies by type:

Text post (Facebook, Threads):

{

"title": "",

"description": "Your post text",

"type": "text",

"medias": [],

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e"

}

Image post (Facebook, Instagram, Threads, TikTok, LinkedIn):

{

"title": "",

"description": "Caption",

"type": "image",

"medias": [{"type": "image", "thumbnail": "url", "url": "url", "alt": "description"}],

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e"

}

Video post (Facebook, Instagram, Threads, TikTok, YouTube, LinkedIn):

{

"title": "Hello there, this is from Repliz",

"description": "Hello there, this is from Repliz",

"type": "video",

"medias": [

{

"type": "video",

"thumbnail": "thumbnail-url",

"url": "video-url"

}

],

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e"

}

Album post (Facebook, Instagram, Threads, TikTok, LinkedIn):

{

"title": "Hello there, this is from Repliz",

"description": "Hello there, this is from Repliz",

"type": "album",

"medias": [

{

"type": "image",

"thumbnail": "thumbnail-url-1",

"url": "image-url-1",

"alt": "alt-image-1"

},

{

"type": "image",

"thumbnail": "thumbnail-url-2",

"url": "image-url-2",

"alt": "alt-image-2"

},

{

"type": "image",

"thumbnail": "thumbnail-url-99",

"url": "image-url-99",

"alt": "alt-image-99"

},

],

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e"

}

Story post (Facebook, Instagram):

{

"title": "",

"description": "",

"type": "story",

"medias": [

{

"type": "image or video", // you can choose

"thumbnail": "thumbnail-url",

"url": "media-url"

}

],

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e"

}

Instagram post with additional info:

{

"title": "Hello there, this is from Repliz",

"description": "Hello there, this is from Repliz",

"type": "video",

"medias": [

{

"type": "video",

"thumbnail": "thumbnail-url",

"url": "video-url"

}

],

"additionalInfo": {

"collaborators": [

"usernameCollab1",

"usernameCollab2",

"usernameCollab3"

]

},

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e"

}

Nested/Thread post (Threads):

{

"title": "",

"description": "First Post",

"type": "text",

"medias": [],

"scheduleAt": "2026-02-14T10:35:09.658Z",

"accountId": "680affa5ce12f2f72916f67e",

"replies": [

{"title": "", "description": "Second Post reply First Post", "type": "text", "medias": []},

{"title": "", "description": "Third Post reply Second Post", "type": "text", "medias": []}

]

}

**DELETE /public/schedule/{_id}**
- Delete scheduled post (cannot be recovered)

---

### Comment Queue

**GET /public/queue**
- Query params: `page`, `limit`, `search`, `status` (pending/resolved/ignored), `accountIds` (can be repeated)
- Returns comment queue from social media

**GET /public/queue/{_id}**
- Get queue item details

**POST /public/queue/{_id}**
- Reply to comment (automatically marks as resolved)

{

"text": "Your reply"

}

---

## Error Handling

- `401`: Invalid authorization header
- `404`: Not found
- `500`: Internal server error

## Notes

- `accountId` for posting comes from `_id` field in account list
- `scheduleAt` uses ISO 8601 format with timezone (e.g., `2026-02-14T10:35:09.658Z`)
- Queue status can be: pending, resolved, ignored