Accounts

Endpoints related to user accounts and social media accounts.

Get current user information

get

Fetches the current user's information, including subscription status and API key if available.

Authorizations

apiKey

blotato-api-keystringRequired

Responses

200

Current user information

application/json

401

Unauthorized

application/json

get

/v2/users/me

HTTPcURLJavaScriptPython

GET /v2/users/me HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "id": "user_12345",
  "subscriptionStatus": "active",
  "apiKey": "your-api-key"
}

Get current user accounts

get

Fetches the current user's social media accounts. Optionally filter by platform.

Authorizations

apiKey

blotato-api-keystringRequired

Query parameters

platformstring · enumOptional

Social media platform

Example: twitterPossible values:

Responses

200

Default Response

application/json

401

Unauthorized

application/json

500

Server error

application/json

get

/v2/users/me/accounts

HTTPcURLJavaScriptPython

GET /v2/users/me/accounts HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    [
      {
        "id": "12345",
        "platform": "twitter",
        "fullname": "John Doe",
        "username": "@johndoe"
      }
    ]
  ]
}

Get current user subaccounts

get

Fetches the current user's subaccounts for a specific account. Subaccounts are typically used for platforms like Facebook where a user can have multiple pages.

Authorizations

apiKey

blotato-api-keystringRequired

Path parameters

accountIdstringRequired

Responses

200

Default Response

application/json

401

Unauthorized

application/json

500

Server error

application/json

get

/v2/users/me/accounts/{accountId}/subaccounts

HTTPcURLJavaScriptPython

GET /v2/users/me/accounts/{accountId}/subaccounts HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "id": "facebook_page_12345",
      "accountId": "account_67890",
      "name": "My Facebook Page"
    }
  ]
}