# SocialOS

> Social infrastructure APIs for building communities, feeds, moderation, gamification, and social graphs. Designed for both human developers and AI agents.

## API Overview

SocialOS provides 16 composable API classes that let you build any social experience:

- **Identity** — User profiles, personas, cross-platform identity
- **Authentication** — Session management, API keys, token auth
- **Onboarding** — OAuth and email signup flows
- **Security** — Roles, permissions, access control
- **Relationships** — Follows, connections, memberships, social graphs
- **Social Actions** — Likes, reposts, comments, reactions
- **Gamification** — Points, badges, leaderboards, rewards
- **Feeds** — Aggregate and filter content from any source
- **Enterprise Feeds** — Curated, moderated feeds for organizations
- **Analytics** — Engagement tracking, scoring, reporting
- **Search** — Full-text search across users, messages, networks
- **Filters** — Rule-based content filtering and routing
- **Triggers** — Event-driven automated actions (webhooks, schedules)
- **Scripts** — Server-side logic and cloud functions
- **Templates** — Pre-built UI components and layouts
- **Scaling** — Rate limiting, caching, infrastructure controls
- **Data Definitions** — Custom schemas and data models

## Authentication

All requests require a Bearer token:

```
Authorization: Bearer YOUR_API_KEY
```

Get a free sandbox API key (instant, no approval): https://app.socialos.io/signup

## Base URLs

- Production: https://api.socialos.io/v2
- Sandbox: https://sandbox.socialos.io/v2

## OpenAPI Specification

Machine-readable API spec (OpenAPI 3.0.3): https://www.socialos.io/openapi.yaml

## Quick Start (5 core operations)

1. Create a user: POST /user
2. Post a message: POST /message
3. Create a network: POST /network
4. Read a feed: GET /message/network/{networkId}
5. Search messages: GET /message/search?query={query}

## API Compatibility

SocialOS supports four API formats — data is interoperable across all:
- Native REST API (this spec)
- Parse-compatible API (mobile apps)
- Slack-compatible API (Web/Events/Conversations)
- Twitter-compatible API (messaging)

## Rate Limits

- Sandbox (free): 2 req/sec
- Starter ($19/mo): 10 req/sec
- Growth ($99/mo): 30 req/sec
- Enterprise (from $499/mo): Unlimited

## SDKs

- Python: pip install socialos
- Ruby: gem install socialos
- Java: io.socialos:socialos-java:2.0.0
- JavaScript: npm install socialos

## Links

- Homepage: https://www.socialos.io
- Documentation: https://docs.socialos.io
- OpenAPI Spec: https://www.socialos.io/openapi.yaml
- Agent Quick Start: https://www.socialos.io/quickstart.html
- Pricing: https://www.socialos.io/pricing.html
- Status: https://status.socialos.io
- Support: developers@socialos.io