Company - hooshid/imdb-scraper GitHub Wiki
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