# Rankem

> Social platform for creating, browsing, and sharing tier lists and rankings.

## Docs

- [API Documentation](https://docs.rankem.com): Full REST API reference
- [OpenAPI Spec](https://api.rankem.com/openapi.json): Machine-readable API specification
- [Authentication](https://docs.rankem.com/authentication): API key authentication guide

## API

Base URL: `https://api.rankem.com/v1`

### Endpoints
- GET /sets — List public sets (supports pagination, sorting, search)
- POST /sets — Create a new set (requires API key)
- GET /sets/:id — Get set details
- GET /sets/:id/items — Get items in a set
- POST /items — Create an item (supports image_url for automatic image processing)
- GET /search?q=term — Search sets and items

### Authentication
All write endpoints require an API key passed via `Authorization: Bearer <key>` header.
Read endpoints are public.

## Tools

- **CLI**: `@rankem/cli` — Command-line interface for Rankem (npx rankem)
- **MCP Server**: `@rankem/mcp` — Model Context Protocol server for AI assistants (Cursor, Claude Desktop)
- **API SDK**: `@rankem/api-sdk` — TypeScript SDK for the Rankem API

## Optional

- [Sitemap](https://rankem.com/sitemap.xml)
- [Directory](https://rankem.com/directory)