TheBiz API Documentation

Access 14,000+ film industry companies across 165 countries

REST API JWT Authentication JSON Responses

Quick Start

1. Authentication

All TheBiz API endpoints require JWT authentication. First, obtain an access token:

curl -X POST "https://quilty.app/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email": "your-email@example.com", "password": "your-password"}'

2. Make API Calls

Include the access token in the Authorization header:

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://quilty.app/api/thebiz/companies"

Base URL

https://quilty.app/api/thebiz

API Endpoints

GET /stats

Get database statistics and overview information.

Example Request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://quilty.app/api/thebiz/stats"

Example Response:

{
  "total_companies": 14284,
  "countries_count": 165,
  "company_types": ["production", "distribution", "sales_agent", ...],
  "top_countries": [
    {"country": "USA", "count": 2813},
    {"country": "UNITED KINGDOM", "count": 1207},
    ...
  ]
}

GET /companies

Search and filter film industry companies with pagination.

Query Parameters:

Parameter	Type	Description
search	string	Search company names (optional)
country	string	Filter by country (optional)
company_type	string	Filter by company type (optional)
page	integer	Page number (default: 1)
per_page	integer	Items per page (1-100, default: 20)

Example Request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://quilty.app/api/thebiz/companies?search=disney&country=USA&per_page=5"

Example Response:

{
  "companies": [
    {
      "id": 5750,
      "name": "Disney Abc Television",
      "company_type": "production",
      "country": "USA",
      "city": "Burbank",
      "market_focus": "international",
      "address": "500 S. Buena Vista Street",
      "tel": "1 818 460 7004"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 5,
    "total": 6,
    "pages": 2,
    "has_next": true,
    "has_prev": false
  },
  "filters": {
    "countries": ["USA", "UNITED KINGDOM", ...],
    "company_types": ["production", "distribution", ...]
  }
}

GET /companies/{id}

Get detailed information about a specific company.

Example Request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://quilty.app/api/thebiz/companies/5750"

Example Response:

{
  "id": 5750,
  "name": "Disney Abc Television",
  "company_type": "production",
  "country": "USA",
  "city": "Burbank",
  "market_focus": "international",
  "address": "500 S. Buena Vista Street",
  "tel": "1 818 460 7004"
}

GET /export

Export company data in CSV or JSON format.

Query Parameters:

Parameter	Type	Description
format	string	"csv" or "json" (default: csv)
per_page	integer	Max items to export (1-5000, default: 1000)
+ All search/filter parameters from /companies endpoint

Example Request:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://quilty.app/api/thebiz/export?format=csv&country=USA&per_page=100" \
  --output companies.csv

Company Types

Available Types:

production - Production companies
distribution - Distribution companies
sales_agent - Sales agents
festival - Film festivals

Additional Types:

organization - Industry organizations
talent_agency - Talent agencies
financial - Financial services
services - Other services

Error Handling

HTTP Status Codes:

200 - Success
401 - Unauthorized (invalid or missing token)
404 - Not found
500 - Internal server error

Error Response Format:

{
  "detail": "Error message describing what went wrong"
}

Rate Limits

• Search queries: 100 requests per minute per user
• Export operations: 5 requests per hour per user
• General API calls: Standard rate limiting applies

Rate limits are enforced per authenticated user. If you exceed the limits, you'll receive a 429 status code.

Support

Need help with the TheBiz API? Here are some resources:

• Try the web interface to explore the data
• View usage analytics (admin access required)
• Check the browser developer console for detailed error messages
• Ensure your JWT token is valid and not expired