Developer API

Integrate ScenePaper's crew database and production tools directly into your workflow. Programmatic access for productions that move at speed.

Authentication

All API requests must include your API key in the Authorization header as a Bearer token.

Authorization: Bearer sp_live_your_api_key_here

Generate an API key from The Booth → API Access. Keys are scoped by permission and rate-limited by tier.

Rate Limits

Tier	Limit	Window
Standard	1,000	per hour
Pro Pro plan	10,000	per hour

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.

Permissions

read_crew

Read Crew

Search crew profiles, view availability and day rates.

write_crew_calls

Write Crew Calls

Create and manage crew calls programmatically.

read_analytics

Read Analytics

Access production analytics and reporting data.

Example — Scout Crew

Search for available crew members using the scout endpoint. Requires the read_crew permission.

curl -X GET \
  "https://gate.scenepaper.com/api/scout/api?role=cinematographer&country=India" \
  -H "Authorization: Bearer sp_live_your_api_key_here"

Response

{
  "crew": [
    {
      "id": "...",
      "name": "Rajan Mehta",
      "primaryRole": "Cinematographer",
      "availability": "available_for_call",
      "location": "Mumbai, India",
      "dayRate": { "amount": 25000, "currency": "INR" }
    }
  ],
  "total": 142,
  "page": 1
}

Base URL

https://gate.scenepaper.com

All API requests go through the Gateway. Direct BE access is not supported.

Ready to integrate?

Generate your first API key from The Booth.

Get API Key