Skip to main content
GET
Get Trends By Woeid
Get the trending topics for a location, identified by its Yahoo WOEID (Where On Earth ID), with an optional count (default 30). Use this for a real-time read on what a specific market is talking about right now — useful for timing content or spotting emerging stories. Returns trend names and volumes under trends. Once you pick a trend, search its posts with get_twitter_tweet_advanced_search.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/twitter/trends
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/twitter/trends
  • count: query; optional
  • woeid: query; optional
  • Runtime facts: bf5a62671fcd8c35ae2726a52eb98202ca01c5f4508e39d1b2bd8ec2dbdd09ef
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.00015 USD (not a fixed price). Declared unit rate: $0.00001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.00015
  • Declared unit rate (USD): 1e-05
  • Billing unit: provider_credit
  • Cost contract: plan_units
  • Published reference multiplier: 1.0
  • Settlement evidence source: request_snapshot

Declared request billing units

  • Units: 15

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

count
string

The number of trends to return. Default is 30.

Provider reference (supplier schema): {"default":30,"format":"int64","minimum":30,"type":"integer"}.

woeid
string

The WOEID of the location. Example: 2418046.

Provider reference (supplier schema): {"format":"int64","type":"integer"}.

Response

Successful response

msg
string
status
enum<string>
Available options:
success,
error