API Use Cases & Workflows

Sales Signal Detection

Monitor LinkedIn for buying intent signals - people talking about problems your product solves, comparing tools, or looking for recommendations.

# 1. Create a keyword watchlist for buying signals
curl -X POST "https://api.outx.ai/api-keyword-watchlist" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Buying Intent - CRM Tools",
    "keywords": [
      "looking for a CRM",
      "CRM recommendation",
      {
        "keyword": "switching from",
        "required_keywords": ["CRM", "sales tool"],
        "excluded_keywords": ["hiring", "job"]
      }
    ],
    "fetchFreqInHours": 6
  }'

# 2. Retrieve the newest posts in the watchlist's default intent buckets
curl -X GET "https://api.outx.ai/api-posts?watchlist_id=YOUR_ID&sort_by=recent&labels=default" \
  -H "x-api-key: YOUR_API_KEY"

What you get: A continuously updated feed of LinkedIn posts from people actively discussing CRM tools, filtered by your keywords and narrowed to the intent labels the watchlist marks as default.

sort_by=relevance_first is a Reddit-only value. On a LinkedIn watchlist, sort by recent, popular_first, or engagement. labels=default resolves to whichever labels the watchlist marks as default, so you do not have to name them.

Competitor Monitoring

To catch posts where other people mention a competitor, use a keyword watchlist with the competitor’s name as a keyword. See Design your watchlists. A company watchlist follows what the competitor itself posts from its own page, not what is said about it. Track what your competitors and their employees are posting on LinkedIn.

# Track competitor company pages
curl -X POST "https://api.outx.ai/api-company-watchlist" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Competitor Companies",
    "companies": [
      "https://linkedin.com/company/competitor-a",
      "https://linkedin.com/company/competitor-b",
      "competitor-c"
    ]
  }'

What you get: Every post from competitor company pages, including announcements, product updates, hiring signals, and thought leadership content.

Hiring & Job Change Alerts

Detect when target accounts are hiring or when key contacts change roles. If you already know who the people are, do not use the keyword recipe below. Put them in a people watchlist and read GET /api-posts?post_type=job_update, which is the structured job-change signal and does not depend on anyone phrasing it a particular way. The keyword scan below is for discovering people you have not identified yet, where a phrase like “excited to announce” is the only handle you have.

# Track hiring keywords
curl -X POST "https://api.outx.ai/api-keyword-watchlist" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Hiring Signals",
    "keywords": [
      {
        "keyword": "hiring",
        "required_keywords": ["VP Sales", "Head of"],
        "excluded_keywords": ["internship", "entry level"]
      },
      "excited to announce",
      "new role"
    ],
    "fetchFreqInHours": 12
  }'

# Filter by seniority level
curl -X GET "https://api.outx.ai/api-posts?watchlist_id=YOUR_ID&seniority_level=VP" \
  -H "x-api-key: YOUR_API_KEY"

Find the most engaging LinkedIn posts in your industry for content inspiration or engagement opportunities.

# Get trending posts from your watchlist
curl -X GET "https://api.outx.ai/api-posts?watchlist_id=YOUR_ID&trending=true&sort_by=engagement" \
  -H "x-api-key: YOUR_API_KEY"

# Filter by post type and date range
curl -X GET "https://api.outx.ai/api-posts?watchlist_id=YOUR_ID&post_type=person&start_date=2026-02-01&end_date=2026-03-01&sort_by=engagement" \
  -H "x-api-key: YOUR_API_KEY"

Automated Engagement Pipeline

Set up a pipeline that monitors posts and automatically engages with relevant content.

import requests
import time

API_KEY = "YOUR_API_KEY"
HEADERS = {"x-api-key": API_KEY}
BASE = "https://api.outx.ai"

# Step 1: Get recent relevant posts
posts = requests.get(
    f"{BASE}/api-posts",
    headers=HEADERS,
    params={
        "watchlist_id": "YOUR_WATCHLIST_ID",
        "sort_by": "recent",
        "labels": "default",  # the watchlist's default intent buckets
        "interacted": "false",  # only posts your team hasn't engaged yet
        "page": 1
    }
).json()

# Step 2: Like the 5 newest posts in the default buckets
for post in posts["data"][:5]:
    requests.post(
        f"{BASE}/api-like",
        headers={**HEADERS, "Content-Type": "application/json"},
        json={
            "post_id": post["id"],
            "user_email": "your.email@company.com",
            "actor_type": "user"
        }
    )
    time.sleep(30)  # Wait between actions for safety

AI Agent Integration

Use the LinkedIn API to give AI agents direct access to LinkedIn data.

import requests
import time

API_KEY = "YOUR_API_KEY"
HEADERS = {"x-api-key": API_KEY, "Content-Type": "application/json"}
BASE = "https://api.outx.ai"

# Fetch a profile for AI analysis
task = requests.post(
    f"{BASE}/linkedin-agent/fetch-profile",
    headers=HEADERS,
    json={"profile_slug": "target-prospect"}
).json()

task_id = task["api_agent_task_id"]

# Poll until complete
while True:
    status = requests.get(
        f"{BASE}/linkedin-agent/get-task-status",
        headers=HEADERS,
        params={"api_agent_task_id": task_id}
    ).json()

    if status["data"]["status"] == "completed":
        profile_data = status["data"]["task_output"]
        # Feed profile_data to your AI agent for analysis
        break

    time.sleep(5)

Use this for: Building AI agents that research prospects, generate personalized outreach, or analyze LinkedIn data as part of automated workflows.

Webhook-Style Monitoring (Polling Pattern)

OutX doesn’t currently offer webhooks, but you can build a polling-based monitoring system:

import requests
import time

API_KEY = "YOUR_API_KEY"
HEADERS = {"x-api-key": API_KEY}
BASE = "https://api.outx.ai"
WATCHLIST_ID = "YOUR_WATCHLIST_ID"

seen_posts = set()

while True:
    posts = requests.get(
        f"{BASE}/api-posts",
        headers=HEADERS,
        params={
            "watchlist_id": WATCHLIST_ID,
            "sort_by": "recent",
            "page": 1
        }
    ).json()

    for post in posts.get("data", []):
        if post["id"] not in seen_posts:
            seen_posts.add(post["id"])
            # Process new post - send to Slack, CRM, AI agent, etc.
            print(f"New post by {post['author_name']}: {post['content'][:100]}")

    time.sleep(3600)  # Check every hour

Quick Start

Make your first API call

LinkedIn API

Direct LinkedIn data access

Posts API

All post filtering options

OutX Blog

Guides and tutorials

Frequently Asked Questions

Can I combine multiple watchlists in a single API call?

No. /api-posts reads exactly one watchlist per call: watchlist_id is required and must be a single string. Passing multiple values, or omitting it, returns a 400. To read several watchlists, call /api-posts once per watchlist_id.

How do I get notified when new posts arrive?

There are two approaches. First, you can poll the /api-posts endpoint periodically with sort_by=recent and track which post IDs you have already seen (see the polling pattern example above). Second, you can set up Slack notifications directly in the OutX UI to receive alerts in your Slack channels without writing any code.

Getting Started

Authentication (OTP)

Keyword Watchlist

People Watchlist

Company Watchlist

Reddit Watchlist

Posts & Engagement

Team & Usage

LinkedIn Data

Integrations

API Use Cases & Workflows

Sales Signal Detection

Competitor Monitoring

Hiring & Job Change Alerts

Automated Engagement Pipeline

AI Agent Integration

Webhook-Style Monitoring (Polling Pattern)

Quick Start

LinkedIn API

Posts API

OutX Blog

Frequently Asked Questions

Learn More

​Sales Signal Detection

​Competitor Monitoring

​Hiring & Job Change Alerts

​Trending Content Discovery

​Automated Engagement Pipeline

​AI Agent Integration

​Webhook-Style Monitoring (Polling Pattern)

​Related Resources

Quick Start

LinkedIn API

Posts API

OutX Blog

​Frequently Asked Questions

​Learn More

Sales Signal Detection

Competitor Monitoring

Hiring & Job Change Alerts

Trending Content Discovery

Automated Engagement Pipeline

AI Agent Integration

Webhook-Style Monitoring (Polling Pattern)

Related Resources

Frequently Asked Questions

Learn More