CompanySearch

CompanySearch Class

The CompanySearch class provides functionality to search for production companies and studios on IMDb, returning detailed information about each matching company.

search()

Method Documentation

Searches for production companies, studios, and other entertainment industry companies on IMDb. Returns comprehensive company data including ranking information, country of origin, and company types.

Method Signature

public function search(string $company, int $limit = 50): array

Parameters

Parameter	Type	Default	Required	Description
company	string		YES	Company name to search for
limit	int	50	NO	Maximum number of results to return

Example Usage

$companySearch = new \Hooshid\ImdbScraper\CompanySearch();
$warnerResults = $companySearch->search("warner brothers");
$disneyResults = $companySearch->search("disney", 20);

Return Value

Key	Type	Description
id	string	IMDb company ID
name	string	Official company name
rank	array	Ranking information with sub-fields
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|null	Country of origin
types	string[]	Array of company types

Example Return

[
    {
        "id": "co0185428",
        "name": "Warner Brothers Entertainment",
        "rank": {
            "current_rank": 1660,
            "change_direction": "UP",
            "difference": 1884
        },
        "country": "United States",
        "types": [
            "Production",
            "Distributor",
            "Special Effects"
        ]
    }
]

Error Handling

• Returns empty array when:
  • Search term is empty after trimming
  • No matching companies found
  • API returns invalid data structure
• Throws Exception on:
  • API request failures
  • Network connectivity issues

Notes

• Search is case-insensitive
• Results include both active and inactive companies
• Some fields may be null if data is unavailable
• Company types vary and may include multiple categories
• Rank information is only available for some companies