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": "active",
    "created_at": "<string>",
    "last_result_at": "<string>",
    "total_results": 123,
    "query": {
      "keywords": [
        "<string>"
      ],
      "monitoring_type": "<string>",
      "keywords_and": [
        "<string>"
      ],
      "keywords_not": [
        "<string>"
      ]
    },
    "updated_at": "<string>",
    "filters": {
      "time_frame": "<string>",
      "max_results": 123,
      "frequency": "<string>",
      "job_titles": [
        "<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, Twitter, Reddit, YouTube, and podcasts. 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, Twitter, Reddit, YouTube, and podcasts
  • Advanced Filtering: AND/OR/NOT keyword logic, job title filters, time frames
  • 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
twitter-postsTwitter/X posts
twitter-profileTwitter/X profile monitoring
reddit-postsReddit posts and comments
youtube-videosYouTube video content
youtube-channelYouTube channel monitoring
podcast-episodesPodcast episode content
podcast-keywordsPodcast keyword monitoring

​
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
DAILYRun once per day
WEEKLYRun once per week
MONTHLYRun once per month

​
Credit Usage

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

​
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
required

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