> ## 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 People Watchlist

> Create a new people watchlist to track multiple LinkedIn profiles

Monitor LinkedIn profiles to track their posts, activity, job changes and birthdays. Perfect for following industry influencers, potential clients, or key stakeholders.

<Note>
  **Platform: LinkedIn only.** People watchlists track LinkedIn profiles; there is no Reddit equivalent. For topic tracking on LinkedIn use `/api-keyword-watchlist`, on Reddit use `/api-reddit-watchlist`. 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="profiles" type="array" required>
  Array of LinkedIn profile identifiers. The API automatically detects and extracts identifiers from various formats (LinkedIn URLs, profile 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 Profile Formats

<AccordionGroup>
  <Accordion title="LinkedIn URLs" icon="link">
    ```json theme={null}
    [
      "https://linkedin.com/in/satyanadella",
      "https://www.linkedin.com/in/sundarpichai/",
      "linkedin.com/in/elon-musk"
    ]
    ```
  </Accordion>

  <Accordion title="Profile Slugs" icon="user">
    ```json theme={null}
    ["bill-gates", "jeff-bezos", "mark-zuckerberg"]
    ```
  </Accordion>

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

    ```json theme={null}
    [
      "urn:li:fs_profileView:ACoAAAfA0wwBG02GBN605w5Zc0MWaDG1CEqM9jE",
      "urn:li:fsd_profile:ACoAAABCDEFGH12345678",
      "urn:li:member:12345678"
    ]
    ```
  </Accordion>

  <Accordion title="Direct URN IDs" icon="hashtag">
    ```json theme={null}
    [
      "ACoAAAfA0wwBG02GBN605w5Zc0MWaDG1CEqM9jE",
      "ACoAAABCDEFGH12345678"
    ]
    ```
  </Accordion>
</AccordionGroup>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.outx.ai/api-people-watchlist" \
    -H "Content-Type: application/json" \
    -H "x-api-key: YOUR_API_KEY" \
    -d '{
      "name": "Tech Leaders",
      "profiles": [
        "https://linkedin.com/in/satyanadella",
        "https://linkedin.com/in/sundarpichai",
        "elon-musk",
        "urn:li:fs_profileView:ACoAAAfA0wwBG02GBN605w5Zc0MWaDG1CEqM9jE",
        "ACoAAABCDEFGH12345678"
      ],
      "description": "Track activity of top tech leaders"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.outx.ai/api-people-watchlist", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY",
    },
    body: JSON.stringify({
      name: "Tech Leaders",
      profiles: [
        "https://linkedin.com/in/satyanadella",
        "https://linkedin.com/in/sundarpichai",
        "elon-musk",
      ],
      description: "Track activity of top tech leaders",
    }),
  });

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

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

  url = 'https://api.outx.ai/api-people-watchlist'
  headers = {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
  }
  payload = {
      'name': 'Tech Leaders',
      'profiles': [
          'https://linkedin.com/in/satyanadella',
          'https://linkedin.com/in/sundarpichai',
          'elon-musk'
      ],
      'description': 'Track activity of top tech leaders'
  }

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

<ResponseExample>
  ```json Response (201 Created) theme={null}
  {
    "id": "770e8400-e29b-41d4-a716-446655440000",
    "name": "Tech Leaders",
    "slug": "tech-leaders-770e8400",
    "type": "people",
    "profiles_count": 5,
    "created": true
  }
  ```
</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 "people" for people watchlists
</ResponseField>

<ResponseField name="profiles_count" type="number">
  Number of profiles added to the watchlist
</ResponseField>

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

## Use Cases

<AccordionGroup>
  <Accordion title="Track Industry Influencers" icon="star">
    Monitor thought leaders in your industry:

    ```json theme={null}
    {
      "name": "AI Thought Leaders",
      "profiles": [
        "https://linkedin.com/in/andrewng",
        "https://linkedin.com/in/ylecun",
        "geoffrey-hinton"
      ]
    }
    ```
  </Accordion>

  <Accordion title="Monitor Potential Clients" icon="handshake">
    Keep tabs on decision-makers at target companies:

    ```json theme={null}
    {
      "name": "Enterprise Prospects",
      "profiles": [
        "cto-company-a",
        "vp-engineering-company-b"
      ]
    }
    ```
  </Accordion>

  <Accordion title="Track Competitors" icon="users-viewfinder">
    Watch what competitor executives are posting:

    ```json theme={null}
    {
      "name": "Competitor Executives",
      "profiles": [
        "competitor-ceo",
        "competitor-cto"
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is there a maximum number of profiles I can add to a single people watchlist?">
    The number of profiles per watchlist depends on your subscription plan. If you try to add more profiles 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 people watchlist?">
    Tracking tasks are created immediately when you create the watchlist. The system begins fetching posts from the tracked profiles right away, and results typically start appearing within a short time depending on Chrome extension activity.
  </Accordion>

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