Skip to main content
Track LinkedIn posts containing specific keywords with powerful filtering options. Monitor industry trends, job postings, or any topic of interest with customizable fetch frequencies.

​
Request Body

​
name
string
Watchlist name. If not provided, a name will be auto-generated based on keywords.
​
keywords
array
required
Array of keywords to track. Can be simple strings or advanced keyword objects with filtering rules.Simple format:
["hiring", "blockchain", "remote work"]
Advanced format with filters:
[
  {
    "keyword": "software engineer",
    "required_keywords": ["remote", "senior"],
    "exclude_keywords": ["unpaid", "intern"]
  }
]
​
description
string
Optional description for the watchlist
​
labels
array
Custom labels for organization
[
  {
    "name": "hiring",
    "description": "Job postings"
  }
]
​
fetchFreqInHours
number
default:"12"
Fetch frequency in hours. Allowed values: 1, 3, 6, 12, 24, 48, 72

​
Advanced Keyword Filtering

Each keyword can have additional filtering rules:
​
keyword
string
required
The primary keyword to search for
​
required_keywords
array
All of these keywords must be present in the post (AND logic)
​
exclude_keywords
array
None of these keywords should be present in the post (NOT logic)
curl -X POST \
  "https://api.outx.ai/api-keyword-watchlist" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "name": "Remote Senior Jobs",
    "keywords": [
      {
        "keyword": "hiring",
        "required_keywords": ["remote", "senior", "engineer"],
        "exclude_keywords": ["unpaid", "intern"]
      },
      {
        "keyword": "job opening",
        "required_keywords": ["work from home"],
        "exclude_keywords": ["junior"]
      }
    ],
    "description": "Track remote senior engineering positions",
    "labels": [
      {
        "name": "hiring",
        "description": "Job postings"
      }
    ],
    "fetchFreqInHours": 6
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Remote Senior Jobs",
  "slug": "remote-senior-jobs-550e8400",
  "type": "keyword",
  "keywords": ["hiring", "job opening"],
  "fetchFreqInHours": 6,
  "created": true,
  "results": [
    {
      "success": true,
      "keyword": "hiring",
      "keyword_id": "660e8400-e29b-41d4-a716-446655440001"
    }
  ]
}

​
Response Fields

​
id
string
Unique identifier for the watchlist
​
name
string
Watchlist name
​
slug
string
URL-friendly slug for the watchlist
​
type
string
Always “keyword” for keyword watchlists
​
keywords
array
Array of tracked keywords
​
fetchFreqInHours
number
Fetch frequency in hours
​
created
boolean
Whether the watchlist was successfully created
​
results
array
Array of keyword creation results

​
Error Responses

Status CodeError MessageDescription
400Missing required parameter: keywordsKeywords array is required
400Invalid fetchFreqInHours valueFetch frequency must be one of: 1, 3, 6, 12, 24, 48, 72
401UnauthorizedInvalid or missing API key

​
Use Cases

Monitor hiring posts for specific roles and locations:
{
  "name": "Remote Engineering Jobs",
  "keywords": [
    {
      "keyword": "hiring",
      "required_keywords": ["engineer", "remote"],
      "exclude_keywords": ["intern", "junior"]
    }
  ]
}
Watch for mentions of competitors:
{
  "name": "Competitor Mentions",
  "keywords": [
    {
      "keyword": "CompetitorName",
      "exclude_keywords": ["partnership", "collaboration"]
    }
  ]
}

​
Frequently Asked Questions

Q: Is there a maximum number of keywords I can add to a single watchlist? The number of keywords per watchlist depends on your subscription plan. Free plans have lower limits, while Pro and Enterprise plans allow more keywords. If you hit your plan’s keyword limit, 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 keyword watchlist? Tracking begins immediately after creation. OutX will start scanning LinkedIn for matching posts on the next fetch cycle, based on the fetchFreqInHours value you set. If you set fetchFreqInHours to 1, you can expect the first results within an hour.
Q: What happens when I hit my plan’s watchlist limit? When you reach the maximum number of watchlists allowed by your plan, the API will return an error when you try to create a new one. You can either delete an existing watchlist to free up a slot, or upgrade your plan for higher limits.