List connected social accounts

Retrieve all social accounts connected to your organization. This endpoint returns all social media profiles that have been connected and authorized through OAuth flows.

Use Cases:

  • View all connected social media accounts for your organization
  • Check which platforms have accounts connected
  • Verify account status and metadata
  • Get account information for use in post creation endpoints
  • Filter accounts by tenant ID, network, username, or unique platform ID

Filtering:

All filter parameters are optional and can be combined for precise queries:

ParameterTypeMatchDescription
idstringExactThe encoded social account ID as returned by the API (e.g. 9dyJS)
tenantIdstringExactYour application's tenant/user identifier, useful in multi-tenant setups
networkstringExactSocial network platform: x, linkedin, instagram, threads, bluesky, facebook, tiktok, youtube, pinterest
networkUniqueIdstringExactThe account's unique identifier on the social network platform
usernamestringPartial, case-insensitiveUsername or handle on the social network

Example requests:

# Get all Instagram accounts
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.outstand.so/v1/social-accounts?network=instagram"

# Get accounts for a specific tenant
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.outstand.so/v1/social-accounts?tenantId=tenant_123"

# Combine filters: Instagram accounts for a tenant
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.outstand.so/v1/social-accounts?network=instagram&tenantId=tenant_123"

# Search by username
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.outstand.so/v1/social-accounts?username=mycompany"

Pagination:

  • Use limit and offset query parameters to paginate results
  • Default limit is 50, maximum is 100

Security: Sensitive OAuth tokens stored in network_data are never exposed in API responses. Only account metadata and identifiers are returned.

GET/v1/social-accounts

Query Parameters

id?string

Filter by social account ID (exact match, encoded ID as returned by the API)

tenantId?string

Filter by tenant ID (exact match)

network?string

Filter by social network platform (exact match, e.g. 'x', 'linkedin', 'instagram', 'threads', 'bluesky', 'facebook', 'tiktok', 'youtube', 'pinterest')

networkUniqueId?string

Filter by the account's unique identifier on the social network platform (exact match)

username?string

Filter by username or handle (case-insensitive partial match)

limit?number

Maximum number of results to return (1-100)

Default50
Range1 <= value <= 100
offset?number

Number of results to skip for pagination

Default0
Range0 <= value

Response Body

curl -X GET "https://api.outstand.so/v1/social-accounts?id=9dyJS&tenantId=tenant_123&network=x&networkUniqueId=123456789&username=mycompany&limit=50&offset=0"
{
  "success": true,
  "data": [
    {
      "id": "9dyJS",
      "orgId": "org_abc123",
      "nickname": "My Company Twitter",
      "network": "x",
      "username": "@mycompany",
      "profile_picture_url": "https://example.com/profile.jpg",
      "network_unique_id": "123456789",
      "customer_social_network_id": 5,
      "accountType": "organization",
      "isActive": 1,
      "createdAt": "2025-01-15T10:30:00Z"
    }
  ],
  "count": 3,
  "limit": 50,
  "offset": 0
}
{
  "success": false,
  "error": "Session expired or invalid"
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}