Skip to main content
The Fetch Company endpoint creates an async task to retrieve full LinkedIn company page data. You provide a company slug (the part after linkedin.com/company/) and receive a task ID to poll for results.

​
Endpoint

POST https://api.outx.ai/linkedin-agent/fetch-company

​
Request Body

​
company_slug
string
required
The LinkedIn company slug (e.g., "microsoft" from linkedin.com/company/microsoft)
The company_slug is the last part of a LinkedIn company URL. For https://www.linkedin.com/company/microsoft, the slug is microsoft.

​
Response

The endpoint returns immediately with a task ID. The actual company data is fetched asynchronously.
​
success
boolean
Whether the task was created successfully
​
api_agent_task_id
string
UUID to poll for results via Get Task Status
​
message
string
Human-readable confirmation
{
  "success": true,
  "api_agent_task_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Company fetch task created successfully"
}

​
Polling for Results

After creating the task, poll the Get Task Status endpoint until the status is completed: 
GET https://api.outx.ai/linkedin-agent/get-task-status?api_agent_task_id=550e8400-e29b-41d4-a716-446655440000

​
Completed Response

When the task finishes, task_output contains the company data: 
{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "task_input": {
      "task_type": "agent_company_fetch",
      "company_slug": "microsoft"
    },
    "task_output": {
      "company": {
        "company_urn": "1035",
        "company_slug": "microsoft",
        "company_type": "Public Company",
        "company_name": "Microsoft",
        "company_website_url": "https://www.microsoft.com",
        "company_founded_on": "1975-01-01",
        "company_industry": "Software Development",
        "company_employee_count": "10001+",
        "company_headquarters": "Redmond, Washington, US",
        "company_description": "Every company has a mission. What's ours? To empower every person and every organization on the planet to achieve more.",
        "company_location": "Redmond, Washington",
        "company_postal_code": "98052",
        "company_logo_url": "https://media.licdn.com/dms/image/..."
      }
    }
  }
}

​
Code Examples

# Create the task
curl -X POST \
  "https://api.outx.ai/linkedin-agent/fetch-company" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"company_slug": "microsoft"}'

# Poll for results
curl -X GET \
  "https://api.outx.ai/linkedin-agent/get-task-status?api_agent_task_id=TASK_ID" \
  -H "x-api-key: YOUR_API_KEY"

​
Error Responses

StatusErrorDescription
400Missing or invalid 'company_slug'The company_slug field is missing or not a string
401Missing API Key / Invalid API KeyAPI key is missing or invalid
403Plugin installation required...No team member has an active Chrome extension. See Authentication

​
FAQ

The company data includes: company_name, company_urn, company_slug, company_type, company_website_url, company_founded_on (as "YYYY-01-01"), company_industry, company_employee_count (as a string range like "1001-5000" or "10001+"), company_headquarters, company_description, company_location, company_postal_code, and company_logo_url. Fields are null when not publicly available on the company page.
The company_slug is the last segment of the LinkedIn company URL. For https://www.linkedin.com/company/google, the slug is google. Do not include the full URL or the /company/ prefix.
The API fetches company data that is visible to the LinkedIn account running the Chrome extension. Most public company pages are accessible. Private or restricted pages may return limited data.
Most company fetch tasks complete within seconds to a few minutes, depending on when the Chrome extension picks up the task. We recommend polling every 5 seconds with a timeout of 2-3 minutes.
The Fetch Company endpoint returns a one-time snapshot of a company’s profile data. The Company Watchlist in the Intelligence API continuously monitors a company’s LinkedIn posts and activity over time, sending you new posts as they are published.

​
Learn More