Skip to main content
GET
/
v1
/
searches
curl -X GET "https://api.trigify.io/v1/searches?limit=20" \
  -H "x-api-key: YOUR_API_KEY"
{
  "message": "<string>",
  "success": true,
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "active",
      "created_at": "<string>",
      "last_result_at": "<string>",
      "total_results": 123
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "<string>"
  }
}
Retrieve all your social listening searches with summary statistics.

Overview

The List Searches endpoint returns all searches you’ve created, along with basic stats like total results and last run time. Use pagination to handle large numbers of searches.

Authentication

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

Key Features

  • Paginated Results: Cursor-based pagination for large result sets
  • Summary Stats: Includes result counts and timestamps
  • No Credit Cost: This endpoint is free to use
curl -X GET "https://api.trigify.io/v1/searches?limit=20" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters

ParameterTypeDefaultDescription
statusstring-Filter by status: active or paused
limitinteger50Number of results per page (max 100)
cursorstring-Pagination cursor from previous response

Response Fields

Each search in the response includes:
FieldDescription
idUnique search identifier
nameSearch name
statusCurrent status: active, paused, running, or completed
created_atWhen the search was created
last_result_atWhen results were last collected
total_resultsTotal number of results found

Credit Usage

This endpoint is free and does not consume credits.

Headers

x-api-key
string
required

Query Parameters

status
enum<string>

Filter by status (active, paused, or archived)

Available options:
active,
paused,
archived
limit
number
default:50

Max results (default 50, max 100)

Required range: 1 <= x <= 100
cursor
string

Pagination cursor

Response

200 - application/json

List of searches

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