Skip to main content
POST
/
v1
/
searches
curl -X POST https://api.trigify.io/v1/searches \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Startup Founders",
    "query": {
      "keywords": ["AI", "artificial intelligence", "machine learning"],
      "keywords_and": ["founder", "CEO"],
      "keywords_not": ["hiring", "job"],
      "monitoring_type": "linkedin-posts"
    },
    "filters": {
      "time_frame": "past-week",
      "max_results": 100,
      "frequency": "DAILY",
      "job_titles": ["Founder", "CEO", "CTO"]
    }
  }'

{
  "message": "<string>",
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "status": "<string>",
    "created_at": "<string>",
    "last_result_at": "<string>",
    "total_results": 123,
    "query": {
      "keywords": [
        "<string>"
      ],
      "monitoring_type": "<string>",
      "keywords_and": [
        "<string>"
      ],
      "keywords_not": [
        "<string>"
      ],
      "profile_url": "<string>",
      "podcast_id": "<string>",
      "podcast_name": "<string>"
    },
    "updated_at": "<string>",
    "filters": {
      "time_frame": "<string>",
      "max_results": 123,
      "frequency": "<string>",
      "job_titles": [
        "<string>"
      ],
      "search_type": "<string>",
      "content_type": "<string>",
      "linkedin_sort_by": "<string>"
    }
  },
  "credits_charged": 123
}
Create a new social listening search to monitor keywords across social platforms.

​
Overview

The Create Search endpoint allows you to set up automated monitoring for specific keywords across LinkedIn, X, Reddit, YouTube, and more. Once created, searches run on a schedule and collect matching content.

​
Authentication

Requires a valid API key with the searches:write permission.

​
Key Features

  • Multi-Platform: Monitor LinkedIn posts, X, Reddit, YouTube, and more
  • Advanced Filtering: AND/OR/NOT keyword logic, job title filters, time frames
  • LinkedIn Mention Targeting: Restrict LinkedIn searches to posts mentioning specific member URNs or company IDs
  • Scheduled Execution: Hourly, daily, weekly, or monthly collection
  • Credit Cost: 1 credit per search created
curl -X POST https://api.trigify.io/v1/searches \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Startup Founders",
    "query": {
      "keywords": ["AI", "artificial intelligence", "machine learning"],
      "keywords_and": ["founder", "CEO"],
      "keywords_not": ["hiring", "job"],
      "monitoring_type": "linkedin-posts"
    },
    "filters": {
      "time_frame": "past-week",
      "max_results": 100,
      "frequency": "DAILY",
      "job_titles": ["Founder", "CEO", "CTO"]
    }
  }'

​
Monitoring Types

TypeDescription
linkedin-postsLinkedIn feed posts
linkedin-profileLinkedIn profile monitoring
substack-postsSubstack posts by keywords/publication
substack-profileSubstack publication monitoring
twitter-postsX posts
twitter-profileX profile monitoring
reddit-postsReddit posts and comments
youtube-videosYouTube video content
youtube-channelYouTube channel monitoring
podcast-episodesPodcast episode content
podcast-keywordsPodcast keyword monitoring
hackernews-storiesHacker News stories
For substack-profile, provide either query.publication (preferred) or query.profile_url.

​
Time Frames

ValueDescription
past-24hLast 24 hours
past-weekLast 7 days
past-monthLast 30 days
past-yearLast 365 days
all-timeNo time limit

​
Frequency Options

ValueDescription
HOURLYRun every hour (Enterprise and Custom plans only)
DAILYRun once per day
WEEKLYRun once per week
MONTHLYRun once per month
QUARTERLYRun once per quarter

​
Credit Usage

This endpoint charges 1 credit per search created. The credits charged are returned in the x-spent-credits response header.

​
LinkedIn Mention Filters

For linkedin-posts, you can additionally pass:
  • filters.mentions_member: array of LinkedIn member URNs
  • filters.mentions_organization: array of LinkedIn company IDs
Example: 
{
  "name": "Posts mentioning Amelia or Microsoft",
  "query": {
    "keywords": ["copilot", "automation"],
    "monitoring_type": "linkedin-posts"
  },
  "filters": {
    "mentions_member": [
      "urn:li:fsd_profile:ACoAAAEkwwAB9KEc2TrQgOLEQ-vzRyZeCDyc6DQ"
    ],
    "mentions_organization": [1035],
    "time_frame": "past-week",
    "frequency": "DAILY"
  }
}
For the full chaining workflow, see LinkedIn Mention Filters.

​
Use Cases

  • Lead Generation: Find prospects discussing relevant topics
  • Competitive Intelligence: Monitor competitor mentions
  • Brand Monitoring: Track mentions of your company or products
  • Market Research: Discover trends and conversations in your industry

Headers

​
x-api-key
string

Body

application/json
​
name
string
required

Name for the search

Required string length: 1 - 255
​
query
object
required
​
filters
object

Response

201 - application/json

Search created successfully

​
message
string
required
​
success
boolean
required
​
data
object
required
​
credits_charged
number
required

Credits charged for this operation