Headless trend API for automation and agents

Developers search for JSON trend endpoints that fit cron jobs, CI checks, and autonomous agents without maintaining scrapers or source-specific SDKs. Trends MCP exposes POST https://api.trendsmcp.ai/api with get_trends, get_growth, and top feeds so the same contract powers MCP clients and bare HTTP callers.

What "headless" means here

Headless means no dashboard required. Callers send JSON bodies, read JSON responses, and store or forward results. That pattern matches how engineers evaluate search APIs for AI agents in 2026 benchmarks: structured output, stable fields, and predictable error codes matter more than a pretty chart UI.

Request skeleton for automation

All operations post to the same URL. Bodies select the mode implicitly through fields: include source and keyword without percent_growth for series, add percent_growth for growth, or set mode to top_trends for live lists. Optional data_mode on REST can request daily versus weekly for Google sources when the pipeline supports it; omit when calling through MCP tools.

Fit with orchestration tools

Zapier and n8n pages already describe no-code wiring. This page speaks to code-first owners who still want the identical backend. A GitHub Action can curl the API nightly, fail the job on 401, and attach the JSON artifact to the run. A LangChain tool wrapper can map user intent to the three operations without forking client code per data source.

Testing and monitoring tips

Golden tests should assert schema, not volatile values. Prefer checking that dates monotonically increase and that growth results include direction strings. Alert when error rates for data_unavailable climb above a baseline, which often signals upstream maintenance rather than bad keywords.

get_trends

Fetch weekly history for a keyword from a single source inside a Python or Node script, then push results to BigQuery or DuckDB.

get_trends(keyword='langchain', source='npm')

get_growth

Compute preset windows such as 30D, 3M, and YTD in one call for OKR dashboards or regression tests on data freshness.

get_growth(keyword='langchain', source='npm', percent_growth=['30D', '3M', 'YTD'])

get_top_trends

Snapshot Reddit Hot Posts or App Store Top Free on a schedule for anomaly alerts without parsing HTML.

get_top_trends(type='Reddit Hot Posts', limit=50)

Common questions

They need machine-readable series for notebooks, Airflow tasks, or LangGraph tools. Browser exports break pipelines. Trends MCP returns arrays of dated points with optional absolute volume fields where the pipeline exposes them, plus growth summaries with explicit baseline and recent dates.
Send Authorization: Bearer YOUR_API_KEY on every call. Do not embed keys in front-end bundles or public repos. Keys are issued from the account page on trendsmcp.ai.
Yes. The same bearer token works for HTTP POST requests and MCP transports documented in llms.txt and the docs site.
Expect 429 when monthly quotas end, 404 when a keyword does not resolve in a source, and data_unavailable when upstream gaps occur. Retry policies should backoff; do not tight-loop on failures.
Get Headless trend API for automation and agents in 30 seconds
Free tier includes 100 requests per month. No credit card required. Works with Claude, Cursor, ChatGPT, Raycast, and every MCP client.
Get your free API key