Company Data Request Parameters

Endpoint

https://gw.magicalapi.com/company-data

The Company Data service requires one of the following parameters in the request body:

Parameter	Type	Required	Description	Example
company_name	string	Optional*	Name of the company	"example"
company_username	string	Optional*	LinkedIn company username (found in company URL after /company/)	"example"
company_website	string	Optional*	Official website URL of the company	"https://www.example.com"

* At least one of these parameters must be provided in the request body.

Sample Request Bodies

Using company name:

{
    "company_name": "example"
}

Using LinkedIn username:

{
    "company_username": "example"
}

Using company website:

{
    "company_website": "https://www.example.com"
}

tip

Important notes:

• You must provide at least one of: company_name, company_username, or company_website
• When using company_username, use the exact username from the LinkedIn URL

Example Workflow

1. Send Initial Request

curl -X POST "https://gw.magicalapi.com/company-data" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR-API-KEY" \
  -d '{"company_name": "example"}'

2. Check Status (using the same endpoint)

curl -X POST "https://gw.magicalapi.com/company-data" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR-API-KEY" \
  -d '{"request_id": "abc123xyz"}'