Roster API

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

Quick Start

$ curl https://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)
slug	string	Look up one designer by exact URL slug (e.g. john-doe)
category	string	Filter by specialty: product, brand, graphic, motion, 3d, director, engineer
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

{
    "success": true,
    "data": [
      {
        "id": "abc123",
        "slug": "john-doe",
        "name": "John Doe",
        "description": "Product designer focused on...",
        "website": "https://johndoe.com",
        "portfolio_preview": "https://.../preview.jpg",
        "category": "product",
        "location": "San Francisco, US",
        "current_role": {
          "title": "Senior Product Designer",
          "company": "Stripe",
          "company_url": "https://stripe.com"
        },
        "previous_roles": [
          { "title": "Product Designer", "company": "Figma", "company_url": null }
        ],
        "profile_url": "https://roster.so/designer/john-doe"
      }
    ],
    "meta": { "total": 127, "limit": 50, "offset": 0, "has_more": true }
  }

Examples

Get all designers

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

Product designers

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

Design directors

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

Designers from Stripe

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

Brand designers in London

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

Search by name

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

MCP Server (Model Context Protocol)

Roster runs a hosted MCP server so AI agents can query the directory directly — no API wiring required.

Remote endpoint (recommended) — add as a custom connector in ChatGPT, Claude, or any MCP client:

https://roster.so/api/mcp

Local (Claude Desktop) — add to your claude_desktop_config.json:

{
  "mcpServers": {
    "roster": {
      "command": "npx",
      "args": ["-y", "@roster-so/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