Skip to main content
GET
/
v1
/
topics
curl -X GET "https://api.trigify.io/v1/topics?page=1&page_size=10" \
  -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>"
    }
  ],
  "pagination": {
    "page": 123,
    "page_size": 123,
    "total_count": 123,
    "total_pages": 123
  }
}
Use this endpoint to list all Social Topics searches for the authenticated organisation.
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 list topic searches.

​
Overview

This endpoint returns paginated topic searches with their current status, monitoring configuration, and recent run metadata. Use it as the index page for your organisation’s Social Topics program.

​
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?page=1&page_size=10" \
  -H "x-api-key: YOUR_API_KEY"

​
Pagination

Query parameters:
  • page: minimum 1, defaults to 1
  • page_size: minimum 1, maximum 100, defaults to 10

​
Example Response

{
  "success": true,
  "message": "Topic searches 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-09T09:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 10,
    "total_count": 1,
    "total_pages": 1
  }
}

​
Status Interpretation

  • ACTIVE: participates in the daily 06:00 UTC rediscovery cadence
  • PAUSED: preserved but excluded from ongoing rediscovery
  • STOPPED: terminal state that cannot be resumed
  • EXPIRED: automatically aged out after the 30-day lifecycle

Headers

​
x-api-key
string

Query Parameters

​
page
integer
default:1

Page number

Required range: x >= 1
​
page_size
integer
default:10

Items per page

Required range: 1 <= x <= 100

Response

200 - application/json

List of topic searches

​
message
string
required
​
success
boolean
required
​
data
object[]
required
​
pagination
object
required