Company Class

The Company class provides detailed information about production companies, studios, and other entertainment industry companies listed on IMDb.

getInfo()

Method Documentation

Retrieves comprehensive information about a specific company including its ranking, staff, known productions, and affiliations. This data is typically only available to IMDbPro subscribers but accessible through this API.

Method Signature

public function getInfo(string $companyId): array

Parameters

Parameter	Type	Default	Required	Description
companyId	string		YES	IMDb company ID (e.g. "co0144901" for Netflix)

Example Usage

$company = new \Hooshid\ImdbScraper\Company();
$netflixInfo = $company->getInfo("co0144901");
$warnerInfo = $company->getInfo("co0185428");

Return Value

Key	Type	Description
id	string	IMDb company ID
name	string	Official company name
rank	array	Ranking information
rank.current_rank	int|null	Current rank position
rank.change_direction	string|null	Direction of rank change (UP/DOWN)
rank.difference	int|null	Amount of rank change
country	string	Country of origin
types	string[]	Array of company types
staff	array[]	List of key staff members
staff[].id	string	Staff member's IMDb ID
staff[].name	string	Staff member's name
staff[].employments	array[]	Employment details
staff[].employments[].employment_title	string	Job title
staff[].employments[].occupation	string	Occupation category
staff[].employments[].branch	string|null	Location/branch
known_for	array[]	Notable productions
known_for[].id	string	Title's IMDb ID
known_for[].title	string	Title name
known_for[].jobs	array[]	Production roles
known_for[].jobs[].category	string	Job category
known_for[].jobs[].job	string	Specific job
known_for[].countries	string[]	Countries of distribution
known_for[].year	int|null	Release year
known_for[].end_year	int|null	End year (for series)
affiliations	array[]	Company relationships
affiliations[].id	string	Affiliated company ID
affiliations[].name	string	Affiliated company name
affiliations[].description	string	Nature of relationship

Example Return

{
    "id": "co0144901",
    "name": "Netflix",
    "rank": {
        "current_rank": 75,
        "change_direction": "DOWN",
        "difference": 39
    },
    "country": "United States",
    "types": [
        "Distributor",
        "Production"
    ],
    "staff": [
        {
            "id": "nm1848253",
            "name": "Ted Sarandos",
            "employments": [
                {
                    "employment_title": "Co-CEO and Chief Content Officer",
                    "occupation": "Executive",
                    "branch": "Los Angeles, CA"
                }
            ]
        }
    ],
    "known_for": [
        {
            "id": "tt10548174",
            "title": "28 Years Later",
            "jobs": [
                {
                    "category": "Distributors",
                    "job": "Distributors"
                }
            ],
            "countries": [
                "United States"
            ],
            "year": 2025,
            "end_year": 2025
        }
    ],
    "affiliations": [
        {
            "id": "co0002257",
            "name": "Constantin Film",
            "description": "Production Deal with"
        }
    ]
}

Error Handling

• Returns empty array when:
  • Invalid or empty company ID provided
  • Company not found in IMDb database
  • API returns incomplete data structure
• Throws Exception on:
  • API request failures
  • Network connectivity issues

Notes

• Company IDs must start with "co" followed by numbers
• Some fields may be null if data is unavailable
• Staff list includes current and former employees
• Known-for titles are limited to most recent/relevant productions
• Affiliations show various business relationships