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.
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 observationslist_keyword_history— phone historylist_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.