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

​
Request Body

​
name
string
Watchlist name. If not provided, a name will be auto-generated.
​
profiles
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).
​
description
string
Optional description for the watchlist
​
list_id
string
Use an existing list ID instead of creating a new one

​
Supported Profile Formats

[
  "https://linkedin.com/in/satyanadella",
  "https://www.linkedin.com/in/sundarpichai/",
  "linkedin.com/in/elon-musk"
]
json [ "bill-gates", "jeff-bezos", "mark-zuckerberg" ]
Full URN format (automatically extracts the unique ID): json [ "urn:li:fs_profileView:ACoAAAfA0wwBG02GBN605w5Zc0MWaDG1CEqM9jE", "urn:li:fsd_profile:ACoAAABCDEFGH12345678", "urn:li:member:12345678" ] 
[
  "ACoAAAfA0wwBG02GBN605w5Zc0MWaDG1CEqM9jE",
  "ACoAAABCDEFGH12345678"
]

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

{
  "id": "770e8400-e29b-41d4-a716-446655440000",
  "name": "Tech Leaders",
  "slug": "tech-leaders-770e8400",
  "type": "people",
  "profiles_count": 5,
  "created": true,
  "tasks_created": 10
}

​
Response Fields

​
id
string
Unique identifier for the watchlist
​
name
string
Watchlist name
​
slug
string
URL-friendly slug for the watchlist
​
type
string
Always “people” for people watchlists
​
profiles_count
number
Number of profiles added to the watchlist
​
created
boolean
Whether the watchlist was successfully created
​
tasks_created
number
Number of tracking tasks created

​
Use Cases

Monitor thought leaders in your industry:
{
  "name": "AI Thought Leaders",
  "profiles": [
    "https://linkedin.com/in/andrewng",
    "https://linkedin.com/in/ylecun",
    "geoffrey-hinton"
  ]
}
Keep tabs on decision-makers at target companies:
{
  "name": "Enterprise Prospects",
  "profiles": [
    "cto-company-a",
    "vp-engineering-company-b"
  ]
}
Watch what competitor executives are posting:
{
  "name": "Competitor Executives",
  "profiles": [
    "competitor-ceo",
    "competitor-cto"
  ]
}

​
Frequently Asked Questions

Q: 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 for details on plan-specific limits.
Q: 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. The tasks_created field in the response confirms how many tracking tasks were queued.
Q: 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.