API / MCP

Keyword API & MCP guide

Read collected keywords, phone history and the hot-keyword view for later site matching. Every request is read-only.

Included in Pro Yearly ($288/year): each account creates its own keys under “API & MCP keys”, each key allowing 10,000 requests a day.

Step 1: create a key

Sign in, open “API & MCP” in the account menu and choose “Create key”. The key is shown once: copy it into a password manager or a server environment variable straight away. It cannot be recovered afterwards, only revoked.

An account can hold up to 10 active keys. Create one per machine so that a leak costs one script, not all of them.

Open the key page

Authorization: Bearer <your key>

Quota and error codes

Each key allows 10,000 requests per UTC day, resetting at 00:00 UTC. The account page shows today's usage across the whole account.

Every successful response carries the remaining quota so a script can slow down before it is refused:

x-api-quota-limit: 10000
x-api-quota-used: 137
x-api-quota-reset: 1761868800
  • 401 invalid_read_token — No Authorization header, or the key was revoked. Opening the endpoint in the browser address bar counts as this too.
  • 403 plan_required — The key is valid, but the account behind it is not an unexpired Pro Yearly subscription.
  • 429 quota_exceeded — This key has spent today's quota; it resets at 00:00 UTC.

Keyword API

GET https://trendis.money/api/v1/keywords

Put the key in an environment variable, then run:

curl -H "Authorization: Bearer $TRENDIS_API_KEY"   'https://trendis.money/api/v1/keywords?source=collected&limit=100'
  • source=collected — All old/new sweep observations, including below-threshold terms. Supports collector=old|new|all, keyword and limit=1..200. Follow nextCursor until null.
  • source=history — Phone observations across 1H, 4H, 24H, 7D and 30D. Supports range, kind, keyword, exact, dedupe, heat, limit and cursor. Follow nextCursor.
  • source=hot — The Rising view with heat at least 1000. Supports page, pageSize=5..200, search, seed, domainStatus, minGrowth and dedup. Read through page/pages.
curl -G -H "Authorization: Bearer $TRENDIS_API_KEY"   --data-urlencode 'source=collected' --data-urlencode 'limit=100'   --data-urlencode 'cursor=<previous nextCursor>'   https://trendis.money/api/v1/keywords

A 7D phone observation can appear in both collected and history. Deduplicate cross-source joins by keyword, window and observation time.

Remote MCP

https://trendis.money/mcp · JSON-RPC over HTTP POST, with the same bearer key.

Add the remote URL in an MCP client that supports custom HTTP headers, and set Authorization: Bearer <key>. The server exposes three tools:

  • list_collected_keywords — collected observations
  • list_keyword_history — phone history
  • list_hot_keywords — hot view

For example, call a tool directly:

curl -H "Authorization: Bearer $TRENDIS_API_KEY"   -H 'Content-Type: application/json'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_collected_keywords","arguments":{"limit":100}}}'   https://trendis.money/mcp

Clients discover the server with initialize and tools/list. The tool result's structuredContent contains items and nextCursor. The MCP URL cannot be inspected through the browser address bar.