Developer platform

Build on live demand, without digging for the contract.

One navigable reference for signal discovery, integrations, automation, and delivery — with runnable examples for every documented route.

Browse 111 endpoints Manage API keys

Base URL

https://staging-api.trendsagi.com

111

Routes

Guides

Languages

Quick picksAds Platform Connectors Shopify BigQuery n8n Slack Webhooks

AutomationRecommended

Webhooks

Generic POST delivery for custom systems and third-party tools

Create signed webhook subscriptions for real-time handoff into internal services, serverless functions, incident tools, CRMs, or any endpoint that accepts POST requests.

Install

No SDK required. Use TrendsAGI webhook integration endpoints.

Required credentials

TRENDSAGI_API_KEY
Destination endpoint URL and downstream auth

Quick Start · bash

export TRENDSAGI_API_KEY="<TRENDSAGI_API_KEY>"
export DESTINATION_URL="https://hooks.example.com/trends"

# 1) Create a webhook subscription
CREATE_RESPONSE=$(curl -s -X POST "https://api.trendsagi.com/api/integrations/webhooks" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"url\": \"$DESTINATION_URL\",
    \"trigger_type\": \"trend_velocity\",
    \"delivery_mode\": \"instant_stream\",
    \"threshold_value\": 50,
    \"cooldown_seconds\": 60
  }")

WEBHOOK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id')

# 2) Send a deterministic test payload
curl -X POST "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/test" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY"

# 3) Inspect recent executions
curl -X GET "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/executions?limit=5" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY"

# 4) Delete the webhook when finished
curl -X DELETE "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY"

Run · bash

# Save as quickstart.sh
bash quickstart.sh

1. Install

Add SDK/dependency for this integration path.

2. Authenticate

Set API key and any provider-specific credentials.

3. Map Endpoints

Use mapped endpoints below to build deterministic flow.

4. Harden

Add rate-limit backoff, idempotency, and safety gates.

Loading API docs...

export TRENDSAGI_API_KEY="<TRENDSAGI_API_KEY>" export DESTINATION_URL="https://hooks.example.com/trends" # 1) Create a webhook subscription CREATE_RESPONSE=$(curl -s -X POST "https://api.trendsagi.com/api/integrations/webhooks" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY" \ -H "Content-Type: application/json" \ -d "{ \"url\": \"$DESTINATION_URL\", \"trigger_type\": \"trend_velocity\", \"delivery_mode\": \"instant_stream\", \"threshold_value\": 50, \"cooldown_seconds\": 60 }") WEBHOOK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id') # 2) Send a deterministic test payload curl -X POST "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/test" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY" # 3) Inspect recent executions curl -X GET "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/executions?limit=5" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY" # 4) Delete the webhook when finished curl -X DELETE "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY"

Build on live demand, without digging for the contract.

Webhooks

Endpoint Mapping

Production Notes

Build on live demand, without digging for the contract.

Webhooks

Endpoint Mapping

Production Notes