Skip to main content
GET
/
v1
/
topics
/
{id}
curl -X GET "https://api.trigify.io/v1/topics/topic_abc123xyz" \
  -H "x-api-key: YOUR_API_KEY"

{
  "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>"
  }
}
Use this endpoint to retrieve the current configuration and monitoring state for one Social Topics search.
Enterprise-only endpoint. Contact us at [email protected] to discuss access.
This is a free read endpoint. Credits are charged when Trigify collects new posts and engagements, not when you inspect a topic search.

​
Overview

This endpoint returns the full topic configuration plus status, timestamps, and recent run metadata. Use it when you need to inspect one topic after creation or before changing its state.

​
Authentication And Permissions

  • Send your API key in x-api-key
  • Required permission: topics:read
  • Required plan: ENTERPRISE or CUSTOM
curl -X GET "https://api.trigify.io/v1/topics/topic_abc123xyz" \
  -H "x-api-key: YOUR_API_KEY"

​
Path Parameter

  • id: the Social Topics search id returned from POST /v1/topics

​
Example Response

{
  "success": true,
  "message": "Topic search retrieved",
  "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": "2026-03-09T06:00:04.000Z",
    "new_items": true,
    "number_of_new_items": 7,
    "created": "2026-03-09T09:30:00.000Z",
    "updated": "2026-03-09T10:12:19.000Z"
  }
}

​
What To Look At

  • status: whether the topic is actively rediscovering
  • last_run: most recent discovery execution
  • new_items and number_of_new_items: whether the last run linked new posts
  • expires_at: when the 30-day lifecycle ends unless the topic is stopped or deleted sooner

Headers

​
x-api-key
string

Path Parameters

​
id
string
required

Topic search ID

Example:

"topic_abc123xyz"

Response

200 - application/json

Topic search details

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