Create Company Watchlist

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"
  }'

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();

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)

{
  "id": "880e8400-e29b-41d4-a716-446655440000",
  "name": "FAANG Companies",
  "slug": "faang-companies-880e8400",
  "type": "company",
  "companies_count": 5,
  "created": true,
  "tasks_created": 5
}

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

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.

Request Body

string

Watchlist name. If not provided, a name will be auto-generated.

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).

string

Optional description for the watchlist

string

Use an existing list ID instead of creating a new one

Supported Company Formats

LinkedIn URLs

[
  "https://linkedin.com/company/google",
  "https://www.linkedin.com/company/microsoft/",
  "linkedin.com/company/apple"
]

Company Slugs

[
  "netflix",
  "amazon",
  "meta"
]

LinkedIn URNs

Full URN format (automatically extracts the unique ID):

[
  "urn:li:fs_company:1234567",
  "urn:li:fsd_company:7654321",
  "urn:li:organization:9999999"
]

Direct URN IDs

Numeric company IDs:

[
  "1234567",
  "7654321"
]

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"
  }'

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();

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)

{
  "id": "880e8400-e29b-41d4-a716-446655440000",
  "name": "FAANG Companies",
  "slug": "faang-companies-880e8400",
  "type": "company",
  "companies_count": 5,
  "created": true,
  "tasks_created": 5
}

Response Fields

string

Unique identifier for the watchlist

string

Watchlist name

string

URL-friendly slug for the watchlist

string

Always “company” for company watchlists

number

Number of companies added to the watchlist

boolean

Whether the watchlist was successfully created

number

Number of tracking tasks created

Use Cases

Competitor Analysis

Monitor competitor company pages for announcements and updates:

{
  "name": "Direct Competitors",
  "companies": [
    "competitor-a",
    "competitor-b",
    "competitor-c"
  ]
}

Partnership Monitoring

Track potential or existing partners:

{
  "name": "Strategic Partners",
  "companies": [
    "partner-company-1",
    "partner-company-2"
  ]
}

Industry Research

Follow companies in your industry vertical:

{
  "name": "SaaS Companies",
  "companies": [
    "salesforce",
    "hubspot",
    "zendesk"
  ]
}

Frequently Asked Questions

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 for details on plan-specific limits.

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.

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.

Delete Get

Getting Started

Authentication (OTP)

Keyword Watchlist

People Watchlist

Company Watchlist

Reddit Watchlist

Posts & Engagement

Team & Usage

LinkedIn Data

Integrations

Create Company Watchlist

Request Body

Supported Company Formats

Response Fields

Use Cases

Frequently Asked Questions

​Request Body

​Supported Company Formats

​Response Fields

​Use Cases

​Frequently Asked Questions

Request Body

Supported Company Formats

Response Fields

Use Cases

Frequently Asked Questions