Roster API

Access the curated directory of world-class designers programmatically. Free, public, no authentication required.

Quick Start

$ curl https://www.roster.so/api/v1/designers

Base URL

https://roster.so/api/v1

Endpoints

Method	Path	Description
GET	/api/v1/designers	List and search all designers
GET	/api/v1/open-roles	List current open design job listings

Query Parameters

Parameter	Type	Description
q	string	Free-text search (name, description, role, company)
category	string	Filter by specialty: product, brand, graphic, motion, directors, engineers
location	string	Filter by location (partial match)
company	string	Filter by current or past company
limit	integer	Results per page (default: 50, max: 100)
offset	integer	Pagination offset

Response Format

{
    "total": 127,
    "limit": 50,
    "offset": 0,
    "designers": [
      {
        "id": "abc123",
        "slug": "john-doe",
        "name": "John Doe",
        "description": "Product designer focused on...",
        "category": "product",
        "location": "San Francisco, US",
        "url": "https://johndoe.com",
        "profileUrl": "https://roster.so/designer/john-doe",
        "currentRole": {
          "title": "Senior Product Designer",
          "company": "Stripe"
        },
        "positions": [
          {
            "title": "Senior Product Designer",
            "company": "Stripe",
            "current": true
          }
        ]
      }
    ]
  }

Examples

Get all designers

https://www.roster.so/api/v1/designers

Product designers

https://www.roster.so/api/v1/designers?category=product

Designers from Stripe

https://www.roster.so/api/v1/designers?company=Stripe

Brand designers in London

https://www.roster.so/api/v1/designers?category=brand&location=London

Search by name

https://www.roster.so/api/v1/designers?q=john

MCP Server (Claude Desktop)

Roster.so provides an MCP (Model Context Protocol) server for direct integration with Claude Desktop and other MCP-compatible AI hosts.

1. Open your Claude Desktop config:

~/.config/claude/claude_desktop_config.json

2. Add the roster MCP server:

{
  "mcpServers": {
    "roster": {
      "command": "npx",
      "args": ["-y", "@roster/mcp-server@latest"]
    }
  }
}

Once configured, Claude can directly search designers, get profiles, and list open roles using the search_designers, get_designer, and list_open_roles tools.

Rate Limits

The API is currently free and public with no strict rate limits. Please be reasonable. If you need higher throughput, contact us.

Resources

OpenAPI Spec

Machine-readable API definition

AI Integration

LLM tool definitions and guides