> ## Documentation Index
> Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Company Watchlist

> Create a new company watchlist to track multiple LinkedIn company pages

Monitor LinkedIn company pages to track their posts, announcements and activities. Perfect for competitor analysis, partnership monitoring, or industry research.

<Note>
  **Platform: LinkedIn only.** Company watchlists track LinkedIn company pages; there is no Reddit equivalent. Collection requires your team's OutX Chrome extension to be installed and active (within the last 48 hours). See [Choose a watchlist type](/docs/api-reference/watchlist/overview).
</Note>

## Request Body

<ParamField body="name" type="string">
  Watchlist name. If not provided, a name will be auto-generated.
</ParamField>

<ParamField body="companies" type="array" required>
  Array of LinkedIn company identifiers. The API automatically detects and extracts identifiers from various formats (LinkedIn URLs, company slugs, LinkedIn URNs, or direct URN IDs).
</ParamField>

<ParamField body="description" type="string">
  Optional description for the watchlist
</ParamField>

<ParamField body="list_id" type="string">
  Use an existing list ID instead of creating a new one
</ParamField>

## Supported Company Formats

<AccordionGroup>
  <Accordion title="LinkedIn URLs" icon="link">
    ```json theme={null}
    [
      "https://linkedin.com/company/google",
      "https://www.linkedin.com/company/microsoft/",
      "linkedin.com/company/apple"
    ]
    ```
  </Accordion>

  <Accordion title="Company Slugs" icon="building">
    ```json theme={null}
    [
      "netflix",
      "amazon",
      "meta"
    ]
    ```
  </Accordion>

  <Accordion title="LinkedIn URNs" icon="fingerprint">
    Full URN format (automatically extracts the unique ID):

    ```json theme={null}
    [
      "urn:li:fs_company:1234567",
      "urn:li:fsd_company:7654321",
      "urn:li:organization:9999999"
    ]
    ```
  </Accordion>

  <Accordion title="Direct URN IDs" icon="hashtag">
    Numeric company IDs:

    ```json theme={null}
    [
      "1234567",
      "7654321"
    ]
    ```
  </Accordion>
</AccordionGroup>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.outx.ai/api-company-watchlist" \
    -H "Content-Type: application/json" \
    -H "x-api-key: YOUR_API_KEY" \
    -d '{
      "name": "FAANG Companies",
      "companies": [
        "https://linkedin.com/company/meta",
        "https://linkedin.com/company/apple",
        "amazon",
        "netflix",
        "https://linkedin.com/company/google"
      ],
      "description": "Track major tech companies"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.outx.ai/api-company-watchlist',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
      },
      body: JSON.stringify({
        name: 'FAANG Companies',
        companies: [
          'https://linkedin.com/company/meta',
          'https://linkedin.com/company/apple',
          'amazon',
          'netflix',
          'https://linkedin.com/company/google'
        ],
        description: 'Track major tech companies'
      })
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  url = 'https://api.outx.ai/api-company-watchlist'
  headers = {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
  }
  payload = {
      'name': 'FAANG Companies',
      'companies': [
          'https://linkedin.com/company/meta',
          'https://linkedin.com/company/apple',
          'amazon',
          'netflix',
          'https://linkedin.com/company/google'
      ],
      'description': 'Track major tech companies'
  }

  response = requests.post(url, headers=headers, json=payload)
  ```
</RequestExample>

<ResponseExample>
  ```json Response (201 Created) theme={null}
  {
    "id": "880e8400-e29b-41d4-a716-446655440000",
    "name": "FAANG Companies",
    "slug": "faang-companies-880e8400",
    "type": "company",
    "companies_count": 5,
    "created": true,
    "tasks_created": 5
  }
  ```
</ResponseExample>

## Response Fields

<ResponseField name="id" type="string">
  Unique identifier for the watchlist
</ResponseField>

<ResponseField name="name" type="string">
  Watchlist name
</ResponseField>

<ResponseField name="slug" type="string">
  URL-friendly slug for the watchlist
</ResponseField>

<ResponseField name="type" type="string">
  Always "company" for company watchlists
</ResponseField>

<ResponseField name="companies_count" type="number">
  Number of companies added to the watchlist
</ResponseField>

<ResponseField name="created" type="boolean">
  Whether the watchlist was successfully created
</ResponseField>

<ResponseField name="tasks_created" type="number">
  Number of tracking tasks created
</ResponseField>

## Use Cases

<AccordionGroup>
  <Accordion title="Competitor Analysis" icon="chart-mixed">
    Monitor competitor company pages for announcements and updates:

    ```json theme={null}
    {
      "name": "Direct Competitors",
      "companies": [
        "competitor-a",
        "competitor-b",
        "competitor-c"
      ]
    }
    ```
  </Accordion>

  <Accordion title="Partnership Monitoring" icon="handshake">
    Track potential or existing partners:

    ```json theme={null}
    {
      "name": "Strategic Partners",
      "companies": [
        "partner-company-1",
        "partner-company-2"
      ]
    }
    ```
  </Accordion>

  <Accordion title="Industry Research" icon="microscope">
    Follow companies in your industry vertical:

    ```json theme={null}
    {
      "name": "SaaS Companies",
      "companies": [
        "salesforce",
        "hubspot",
        "zendesk"
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is there a maximum number of companies I can add to a single watchlist?">
    The number of companies per watchlist depends on your subscription plan. If you try to add more companies than your plan allows, the API will return an error. Contact [support@outx.ai](mailto:support@outx.ai) for details on plan-specific limits.
  </Accordion>

  <Accordion title="How soon does tracking start after I create a company watchlist?">
    Tracking tasks are created immediately when you create the watchlist. The system begins fetching posts from the tracked company pages right away, and results typically start appearing within a short time depending on Chrome extension activity. The `tasks_created` field in the response confirms how many tracking tasks were queued.
  </Accordion>

  <Accordion title="What happens when I hit my plan's limit for tracked companies?">
    When you reach your plan's company tracking limit, the API will return an error when you try to add more companies. You can remove companies from existing watchlists or delete unused watchlists to free up capacity, or upgrade your plan for higher limits.
  </Accordion>
</AccordionGroup>