Skip to main content
POST
/
v1
/
topics
curl -X POST https://api.trigify.io/v1/topics \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Infrastructure Buyers",
    "keywords": ["ai infrastructure", "model serving", "vector database"],
    "keywords_and": ["buying", "vendor selection"],
    "keywords_not": ["hiring", "job opening"],
    "job_titles": ["CTO", "VP Engineering", "Head of Data"],
    "time_frame": "past-week",
    "max_results": 50,
    "content_type": "posts",
    "sort_by": "date_posted"
  }'

{
  "message": "<string>",
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "status": "ACTIVE",
    "keywords": [
      "<string>"
    ],
    "keywords_and": [
      "<string>"
    ],
    "keywords_not": [
      "<string>"
    ],
    "job_titles": [
      "<string>"
    ],
    "time_frame": "<string>",
    "max_results": 123,
    "content_type": "<string>",
    "sort_by": "<string>",
    "expires_at": "<string>",
    "last_run": "<string>",
    "new_items": true,
    "number_of_new_items": 123,
    "created": "<string>",
    "updated": "<string>"
  },
  "credits_charged": 123
}
Use this endpoint to create a Social Topics search and start LinkedIn monitoring immediately.
Enterprise-only endpoint. Contact us at [email protected] to discuss access.
Topic creation itself is free. Credits are charged later when Trigify collects new posts and new engagements for the topic.

​
Overview

This endpoint creates a topic definition for one organisation and immediately kicks off the first discovery run. Any matched posts linked during that first run are hydrated right away for an initial engagement pull.

​
Authentication And Permissions

  • Send your API key in x-api-key
  • Required permission: topics:write
  • Required plan: ENTERPRISE or CUSTOM
curl -X POST https://api.trigify.io/v1/topics \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Infrastructure Buyers",
    "keywords": ["ai infrastructure", "model serving", "vector database"],
    "keywords_and": ["buying", "vendor selection"],
    "keywords_not": ["hiring", "job opening"],
    "job_titles": ["CTO", "VP Engineering", "Head of Data"],
    "time_frame": "past-week",
    "max_results": 50,
    "content_type": "posts",
    "sort_by": "date_posted"
  }'

​
Request Parameters

ParameterRequiredDescription
nameYesHuman-readable topic search name (1–255 characters)
keywordsYesPrimary keywords, at least one value
keywords_andNoTerms that must all match
keywords_notNoTerms that exclude a post
job_titlesNoJob-title filter applied to matched people context
time_frameNoLinkedIn recency window. One of: past-24h, past-week, past-month, past-year, all-time
max_resultsNoPer-run cap, minimum 1, maximum 500
content_typeNoLinkedIn content type filter. One of: posts, videos, photos, liveVideos, collaborativeArticles, documents
sort_byNoSort order. One of: date_posted, relevance. Defaults to date_posted

​
What Happens After Create

  1. The topic search row is created with status ACTIVE.
  2. Trigify enqueues immediate discovery for that topic definition.
  3. Newly linked posts are hydrated right away for an initial engagement pull.
  4. The topic enters the normal daily 06:00 UTC rediscovery cadence.
  5. Tracked posts continue through the Day 1, Day 3, and Day 5 follow-up schedule while at least one eligible active topic still references them.

​
Example Response

{
  "success": true,
  "message": "Topic search created successfully",
  "data": {
    "id": "topic_abc123xyz",
    "name": "AI Infrastructure Buyers",
    "status": "ACTIVE",
    "keywords": ["ai infrastructure", "model serving", "vector database"],
    "keywords_and": ["buying", "vendor selection"],
    "keywords_not": ["hiring", "job opening"],
    "job_titles": ["CTO", "VP Engineering", "Head of Data"],
    "time_frame": "past-week",
    "max_results": 50,
    "content_type": "posts",
    "sort_by": "date_posted",
    "expires_at": "2026-04-08T09:30:00.000Z",
    "last_run": null,
    "new_items": false,
    "number_of_new_items": 0,
    "created": "2026-03-09T09:30:00.000Z",
    "updated": "2026-03-09T09:30:00.000Z"
  },
  "credits_charged": 0
}

​
Credit Model

  • creating the topic search costs 0 credits
  • each newly collected post costs 1 credit
  • each newly collected engagement costs 5 credits
The create response also returns x-spent-credits: 0.

Headers

​
x-api-key
string

Body

application/json
​
name
string
required

Topic search name

Required string length: 1 - 255
​
keywords
string[]
required

Primary keywords (at least 1)

Minimum array length: 1
Minimum string length: 1
​
keywords_and
string[]

AND keywords

​
keywords_not
string[]

NOT keywords

​
job_titles
string[]

Job title filters

​
time_frame
string

Time frame filter

​
max_results
integer

Max results per run

Required range: 1 <= x <= 500
​
content_type
string

Content type filter

​
sort_by
string

Sort order (default: date_posted)

Response

201 - application/json

Topic search created successfully

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

Credits charged for this operation