Skip to main content
GET
/
v1
/
searches
/
{id}
curl -X GET "https://api.trigify.io/v1/searches/search_abc123xyz" \
  -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,
    "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>"
      ]
    },
    "stats": {
      "results_today": 123,
      "results_this_week": 123
    }
  }
}
Retrieve detailed information about a specific search including its configuration and statistics.

Overview

The Get Search endpoint returns the full configuration of a search, including all query parameters, filters, and usage statistics.

Authentication

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

Key Features

  • Full Configuration: Returns all search settings
  • Statistics: Includes result counts and performance stats
  • No Credit Cost: This endpoint is free to use
curl -X GET "https://api.trigify.io/v1/searches/search_abc123xyz" \
  -H "x-api-key: YOUR_API_KEY"

Path Parameters

ParameterTypeDescription
idstringThe unique search ID

Response Fields

FieldDescription
idUnique search identifier
nameSearch name
statusCurrent status
created_atCreation timestamp
updated_atLast update timestamp
last_result_atWhen results were last collected
total_resultsTotal results found
querySearch query configuration
query.keywordsOR keywords (any match)
query.keywords_andAND keywords (all must match)
query.keywords_notNOT keywords (exclusions)
query.monitoring_typePlatform being monitored
filtersSearch filter settings
statsPerformance statistics

Credit Usage

This endpoint is free and does not consume credits.

Headers

x-api-key
string
required

Path Parameters

id
string
required

Search ID

Example:

"search_abc123xyz"

Response

200 - application/json

Search details

message
string
required
success
boolean
required
data
object
required