AI AGENTS / HTTP API

Give every agent one evidence-backed Next Move.

TrendsFast turns a public product URL and bounded trend evidence into structured JSON that any approved, HTTP-capable agent can request and poll.

AVAILABLE

One ordinary HTTP contract.

  • REST API
  • Structured Next Move JSON
  • Async status endpoint
  • Project-scoped API keys for approved users
  • HTTP workflow examples

COMING SOON

No connector theater.

  • TrendsFast CLI
  • MCP server
  • Native connectors

A generic HTTP example is not a native integration.

EXAMPLE WORKFLOWS

Use the tool already in your stack.

Each example uses the same authenticated create, poll, and result sequence.

ChatGPT

Example HTTP workflow

Claude

Example HTTP workflow

Codex

Example HTTP workflow

Cursor

Example HTTP workflow

OpenClaw

Example HTTP workflow

Hermes

Example HTTP workflow

n8n

Example HTTP workflow

Make

Example HTTP workflow

Zapier

Example HTTP workflow

CREATE → POLL → DECIDE

The same result humans see.

Keys are unique to an approved project, shown once, bounded by rate and provider-cost controls, and revocable. Result polling does not create a research run.

01POST /v1/next-moveCREATE
curl -X POST https://trendsfast.com/v1/next-move \
  -H "Authorization: Bearer tf_live_<prefix>.<secret>" \
  -H "Idempotency-Key: 4a2d1201-9666-4ef0-90a9-e5aa47786c8e" \
  -H "Content-Type: application/json" \
  -d '{
    "product_url": "https://example.com",
    "goal": "qualified_signups",
    "market": "US",
    "language": "en",
    "preferred_channels": ["x", "linkedin"]
  }'
02202 AcceptedPOLL
HTTP/1.1 202 Accepted
Location: https://trendsfast.com/v1/next-moves/scan_01J...

{
  "id": "scan_01J...",
  "status": "QUEUED",
  "status_url": "https://trendsfast.com/v1/next-moves/scan_01J..."
}
03GET status_urlREADY
GET /v1/next-moves/scan_01J...

{
  "status": "READY",
  "next_move": {
    "action": "PUBLISH",
    "channel": "x",
    "topic": "Evidence-first distribution agents",
    "confidence": 0.82,
    "valid_until": "<absolute ISO-8601 timestamp>"
  },
  "why_now": {
    "signal_class": "CORROBORATED_SIGNAL",
    "independent_source_count": 3
  },
  "evidence": [{ "url": "https://original.example/..." }],
  "founder_reviewed": true,
  "auto_publish": false
}

PROVE VALUE BEFORE ACCESS

Start with one founder-reviewed scan.