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