Common Endpoints

This section documents the common endpoints available for managing accounts and retrieving post information.

Base URL

https://api.multi-upload-tool.com/api/v1

Authentication

All requests require an API Token in the header: x-api-token: YOUR_API_TOKEN

List Connected Accounts

Retrieve a list of all social media accounts connected to your profile.

Endpoint

GET /accounts

Example Request


curl -X GET https://api.multi-upload-tool.com/api/v1/accounts \
  -H "x-api-token: YOUR_API_TOKEN"

Example Response


{
  "success": true,
  "data": [
    {
      "id": 123,
      "platform": "tiktok",
      "accountName": "my_tiktok_user",
      "profileImageUrl": "https://...",
      "status": "connected",
      "connectedAt": "2023-01-01T12:00:00.000Z"
    },
    {
      "id": 124,
      "platform": "instagram",
      "accountName": "my_insta_user",
      "profileImageUrl": "https://...",
      "status": "connected",
      "connectedAt": "2023-01-02T12:00:00.000Z"
    }
  ]
}

List Posts

Retrieve a list of posts you have uploaded. Supports pagination and filtering.

Endpoint

GET /posts

Query Parameters

Parameter	Type	Required	Description
`page`	number	No	Page number (default: 1).
`perPage`	number	No	Items per page (default: 20, max: 100).
`platform`	string	No	Filter by platform (`tiktok`, `instagram`, `youtube`).
`status`	string	No	Filter by status (`pending`, `completed`, `failed`, `scheduled`).

Example Request


curl -X GET "https://api.multi-upload-tool.com/api/v1/posts?page=1&perPage=10&platform=tiktok" \
  -H "x-api-token: YOUR_API_TOKEN"

Example Response


{
  "success": true,
  "data": [
    {
      "id": 456,
      "title": "My amazing video",
      "platform": "tiktok",
      "status": "completed",
      "uploadedAt": "2023-10-27T10:00:00.000Z",
      "metadata": "..."
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 10
  }
}

Get Post Status

Retrieve the details and status of a specific post by its ID.

Endpoint

GET /posts/:id

Parameters

Parameter	Type	Required	Description
`id`	number	Yes	The ID of the post/upload.

Example Request


curl -X GET https://api.multi-upload-tool.com/api/v1/posts/456 \
  -H "x-api-token: YOUR_API_TOKEN"

Example Response


{
  "success": true,
  "data": {
    "id": 456,
    "userId": 1,
    "connectedAccountId": 123,
    "platform": "tiktok",
    "title": "My amazing video",
    "status": "completed",
    "uploadedAt": "2023-10-27T10:00:00.000Z",
    "metadata": "{\"videoId\":\"v123456\",\"shareUrl\":\"...\"}",
    "fileSize": "15000000"
  }
}

Get TikTok Stats

Retrieve basic statistics for a connected TikTok account.

Endpoint

GET /tiktok/stats

Query Parameters

Parameter	Type	Required	Description
`accountId`	string	Yes	The ID of the connected TikTok account.

Example Request


curl -X GET "https://api.multi-upload-tool.com/api/v1/tiktok/stats?accountId=123" \
  -H "x-api-token: YOUR_API_TOKEN"

Example Response


{
  "success": true,
  "data": {
    "follower_count": 1000,
    "following_count": 50,
    "likes_count": 5000,
    "video_count": 20
  }
}