API Reference

Companies API

Manage company profiles for brand-consistent video generation. Companies can have associated persons, locations, and branding assets.

List Companies

GET/companies

List all companies

bash

curl https://api.twin.actor/api/v1/companies \
  -H "Authorization: Bearer YOUR_TOKEN"

Create Company

POST/companies

Create a new company

Request Body

Name	Type	Description
`name`required	`string`	Company name
`website`	`string`	Company website URL
`description`	`string`	Company description
`logo_base64`	`string`	Logo as base64 data URL

bash

curl -X POST https://api.twin.actor/api/v1/companies \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation",
    "website": "https://acme.com",
    "description": "Leading provider of innovative solutions"
  }'

Extract Company Info

POST/companies/{id}/extract

Extract info from company website

Automatically scrapes the company website to extract name, description, logo, and contact information.

bash

curl -X POST https://api.twin.actor/api/v1/companies/1/extract \
  -H "Authorization: Bearer YOUR_TOKEN"

Each user account includes a demo company (Tesla) with Elon Musk as a spokesperson for testing.