/trends/Get trends near a location (Beta)
Trends
Cost / request
$0.01
Response format
JSON
Protocol
REST
About this endpoint
Access X data through agntdata: Get trends near a location (Beta). Returns the top 50 trending topics for a specific id (woeid), if trending information is available for it. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need tweets, user profiles, followers, search, and hashtag streams programmatically.
Use cases
AI agents that need X data in structured form
Analytics and monitoring pipelines for X content
Research and GTM workflows that combine X signals with other data
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| woeid | query | string | required | —Default: 1 |
Responses
Response
{
"type": "array",
"items": {
"type": "object",
"properties": {
"trends": {
"type": "array",
"items": {
"type": "object"
}
},
"as_of": {
"type": "string"
},
"created_at": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"woeid": {
"type": "integer"
}
}
}
}
}
}
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "Get_trends_near_a_location__Beta__get__trends",
"method": "get",
"path": "/trends/",
"summary": "Get trends near a location (Beta)",
"description": "Returns the top 50 trending topics for a specific id (woeid), if trending information is available for it.",
"parameters": [
{
"name": "woeid",
"in": "query",
"required": true,
"schema": {
"type": "string",
"default": "1"
}
}
],
"responses": [
{
"statusCode": "200",
"description": "Response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"trends": {
"type": "array",
"items": {
"type": "object"
}
},
"as_of": {
"type": "string"
},
"created_at": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"woeid": {
"type": "integer"
}
}
}
}
}
}
},
"example": [
{
"trends": [
{
"name": "Brighton",
"url": "http://twitter.com/search?q=Brighton",
"promoted_content": null,
"query": "Brighton",
"tweet_volume": 78216
},
{
"name": "#SnoopyCEO",
"url": "http://twitter.com/search?q=%23SnoopyCEO",
"promoted_content": null,
"query": "%23SnoopyCEO",
"tweet_volume": null
},
{
"name": "#Venue101",
"url": "http://twitter.com/search?q=%23Venue101",
"promoted_content": null,
"query": "%23Venue101",
"tweet_volume": 60593
},
{
"name": "#SixTONESANN",
"url": "http://twitter.com/search?q=%23SixTONESANN",
"promoted_content": null,
"query": "%23SixTONESANN",
"tweet_volume": 57131
},
{
"name": "السودان",
"url": "http://twitter.com/search?q=%D8%A7%D9%84%D8%B3%D9%88%D8%AF%D8%A7%D9%86",
"promoted_content": null,
"query": "%D8%A7%D9%84%D8%B3%D9%88%D8%AF%D8%A7%D9%86",
"tweet_volume": 91833
},
{
"name": "#CheBha",
"url": "http://twitter.com/search?q=%23CheBha",
"promoted_content": null,
"query": "%23CheBha",
"tweet_volume": 42268
},
{
"name": "Enciso",
"url": "http://twitter.com/search?q=Enciso",
"promoted_content": null,
"query": "Enciso",
"tweet_volume": null
},
{
"name": "#VFBBVB",
"url": "http://twitter.com/search?q=%23VFBBVB",
"promoted_content": null,
"query": "%23VFBBVB",
"tweet_volume": null
},
{
"name": "Chalobah",
"url": "http://twitter.com/search?q=Chalobah",
"promoted_content": null,
"query": "Chalobah",
"tweet_volume": null
},
{
"name": "Dortmund",
"url": "http://twitter.com/search?q=Dortmund",
"promoted_content": null,
"query": "Dortmund",
"tweet_volume": 14619
},
{
"name": "エンシソ",
"url": "http://twitter.com/search?q=%E3%82%A8%E3%83%B3%E3%82%B7%E3%82%BD",
"promoted_content": null,
"query": "%E3%82%A8%E3%83%B3%E3%82%B7%E3%82%BD",
"tweet_volume": null
},
{
"name": "Mitoma",
"url": "http://twitter.com/search?q=Mitoma",
"promoted_content": null,
"query": "Mitoma",
"tweet_volume": 14164
},
{
"name": "Watkins",
"url": "http://twitter.com/search?q=Watkins",
"promoted_content": null,
"query": "Watkins",
"tweet_volume": 38148
},
{
"name": "Pulisic",
"url": "http://twitter.com/search?q=Pulisic",
"promoted_content": null,
"query": "Pulisic",
"tweet_volume": null
},
{
"name": "Sanchez",
"url": "http://twitter.com/search?q=Sanchez",
"promoted_content": null,
"query": "Sanchez",
"tweet_volume": 70962
},
{
"name": "Welbeck",
"url": "http://twitter.com/search?q=Welbeck",
"promoted_content": null,
"query": "Welbeck",
"tweet_volume": null
},
{
"name": "ブライトン",
"url": "http://twitter.com/search?q=%E3%83%96%E3%83%A9%E3%82%A4%E3%83%88%E3%83%B3",
"promoted_content": null,
"query": "%E3%83%96%E3%83%A9%E3%82%A4%E3%83%88%E3%83%B3",
"tweet_volume": null
},
{
"name": "Aston Villa",
"url": "http://twitter.com/search?q=%22Aston+Villa%22",
"promoted_content": null,
"query": "%22Aston+Villa%22",
"tweet_volume": 46268
},
{
"name": "Newcastle",
"url": "http://twitter.com/search?q=Newcastle",
"promoted_content": null,
"query": "Newcastle",
"tweet_volume": 56039
},
{
"name": "Kepa",
"url": "http://twitter.com/search?q=Kepa",
"promoted_content": null,
"query": "Kepa",
"tweet_volume": 13224
},
{
"name": "Bournemouth",
"url": "http://twitter.com/search?q=Bournemouth",
"promoted_content": null,
"query": "Bournemouth",
"tweet_volume": 24430
},
{
"name": "Gallagher",
"url": "http://twitter.com/search?q=Gallagher",
"promoted_content": null,
"query": "Gallagher",
"tweet_volume": 18059
},
{
"name": "Unai Emery",
"url": "http://twitter.com/search?q=%22Unai+Emery%22",
"promoted_content": null,
"query": "%22Unai+Emery%22",
"tweet_volume": 15725
},
{
"name": "Caicedo",
"url": "http://twitter.com/search?q=Caicedo",
"promoted_content": null,
"query": "Caicedo",
"tweet_volume": null
},
{
"name": "Tottenham",
"url": "http://twitter.com/search?q=Tottenham",
"promoted_content": null,
"query": "Tottenham",
"tweet_volume": 31882
},
{
"name": "ウェルベック",
"url": "http://twitter.com/search?q=%E3%82%A6%E3%82%A7%E3%83%AB%E3%83%99%E3%83%83%E3%82%AF",
"promoted_content": null,
"query": "%E3%82%A6%E3%82%A7%E3%83%AB%E3%83%99%E3%83%83%E3%82%AF",
"tweet_volume": null
},
{
"name": "DOJAEJUNG DEBUT TOMORROW",
"url": "http://twitter.com/search?q=%22DOJAEJUNG+DEBUT+TOMORROW%22",
"promoted_content": null,
"query": "%22DOJAEJUNG+DEBUT+TOMORROW%22",
"tweet_volume": 51745
},
{
"name": "ドラケン",
"url": "http://twitter.com/search?q=%E3%83%89%E3%83%A9%E3%82%B1%E3%83%B3",
"promoted_content": null,
"query": "%E3%83%89%E3%83%A9%E3%82%B1%E3%83%B3",
"tweet_volume": null
},
{
"name": "Zakaria",
"url": "http://twitter.com/search?q=Zakaria",
"promoted_content": null,
"query": "Zakaria",
"tweet_volume": null
},
{
"name": "チャロバー",
"url": "http://twitter.com/search?q=%E3%83%81%E3%83%A3%E3%83%AD%E3%83%90%E3%83%BC",
"promoted_content": null,
"query": "%E3%83%81%E3%83%A3%E3%83%AD%E3%83%90%E3%83%BC",
"tweet_volume": null
},
{
"name": "Sudan",
"url": "http://twitter.com/search?q=Sudan",
"promoted_content": null,
"query": "Sudan",
"tweet_volume": 81319
},
{
"name": "Mudryk",
"url": "http://twitter.com/search?q=Mudryk",
"promoted_content": null,
"query": "Mudryk",
"tweet_volume": 19378
},
{
"name": "Valladolid",
"url": "http://twitter.com/search?q=Valladolid",
"promoted_content": null,
"query": "Valladolid",
"tweet_volume": 11964
},
{
"name": "チェルシー",
"url": "http://twitter.com/search?q=%E3%83%81%E3%82%A7%E3%83%AB%E3%82%B7%E3%83%BC",
"promoted_content": null,
"query": "%E3%83%81%E3%82%A7%E3%83%AB%E3%82%B7%E3%83%BC",
"tweet_volume": null
},
{
"name": "ムドリク",
"url": "http://twitter.com/search?q=%E3%83%A0%E3%83%89%E3%83%AA%E3%82%AF",
"promoted_content": null,
"query": "%E3%83%A0%E3%83%89%E3%83%AA%E3%82%AF",
"tweet_volume": null
},
{
"name": "マイキー",
"url": "http://twitter.com/search?q=%E3%83%9E%E3%82%A4%E3%82%AD%E3%83%BC",
"promoted_content": null,
"query": "%E3%83%9E%E3%82%A4%E3%82%AD%E3%83%BC",
"tweet_volume": null
},
{
"name": "Porro",
"url": "http://twitter.com/search?q=Porro",
"promoted_content": null,
"query": "Porro",
"tweet_volume": null
},
{
"name": "Stuttgart",
"url": "http://twitter.com/search?q=Stuttgart",
"promoted_content": null,
"query": "Stuttgart",
"tweet_volume": null
},
{
"name": "Perisic",
"url": "http://twitter.com/search?q=Perisic",
"promoted_content": null,
"query": "Perisic",
"tweet_volume": null
},
{
"name": "De Zerbi",
"url": "http://twitter.com/search?q=%22De+Zerbi%22",
"promoted_content": null,
"query": "%22De+Zerbi%22",
"tweet_volume": null
},
{
"name": "WE DEMAND TRANSPARENCY",
"url": "http://twitter.com/search?q=%22WE+DEMAND+TRANSPARENCY%22",
"promoted_content": null,
"query": "%22WE+DEMAND+TRANSPARENCY%22",
"tweet_volume": 143318
},
{
"name": "会食恐怖症",
"url": "http://twitter.com/search?q=%E4%BC%9A%E9%A3%9F%E6%81%90%E6%80%96%E7%97%87",
"promoted_content": null,
"query": "%E4%BC%9A%E9%A3%9F%E6%81%90%E6%80%96%E7%97%87",
"tweet_volume": null
},
{
"name": "ギャラガー",
"url": "http://twitter.com/search?q=%E3%82%AE%E3%83%A3%E3%83%A9%E3%82%AC%E3%83%BC",
"promoted_content": null,
"query": "%E3%82%AE%E3%83%A3%E3%83%A9%E3%82%AC%E3%83%BC",
"tweet_volume": null
},
{
"name": "サンチェス",
"url": "http://twitter.com/search?q=%E3%82%B5%E3%83%B3%E3%83%81%E3%82%A7%E3%82%B9",
"promoted_content": null,
"query": "%E3%82%B5%E3%83%B3%E3%83%81%E3%82%A7%E3%82%B9",
"tweet_volume": null
},
{
"name": "Jackie Robinson",
"url": "http://twitter.com/search?q=%22Jackie+Robinson%22",
"promoted_content": null,
"query": "%22Jackie+Robinson%22",
"tweet_volume": 10427
},
{
"name": "Notifications",
"url": "http://twitter.com/search?q=Notifications",
"promoted_content": null,
"query": "Notifications",
"tweet_volume": 47736
},
{
"name": "狩野どの",
"url": "http://twitter.com/search?q=%E7%8B%A9%E9%87%8E%E3%81%A9%E3%81%AE",
"promoted_content": null,
"query": "%E7%8B%A9%E9%87%8E%E3%81%A9%E3%81%AE",
"tweet_volume": null
},
{
"name": "コッペピンポンパンさん",
"url": "http://twitter.com/search?q=%E3%82%B3%E3%83%83%E3%83%9A%E3%83%94%E3%83%B3%E3%83%9D%E3%83%B3%E3%83%91%E3%83%B3%E3%81%95%E3%82%93",
"promoted_content": null,
"query": "%E3%82%B3%E3%83%83%E3%83%9A%E3%83%94%E3%83%B3%E3%83%9D%E3%83%B3%E3%83%91%E3%83%B3%E3%81%95%E3%82%93",
"tweet_volume": null
},
{
"name": "Ziyech",
"url": "http://twitter.com/search?q=Ziyech",
"promoted_content": null,
"query": "Ziyech",
"tweet_volume": null
},
{
"name": "Pioli",
"url": "http://twitter.com/search?q=Pioli",
"promoted_content": null,
"query": "Pioli",
"tweet_volume": null
}
],
"as_of": "2023-04-15T15:31:48Z",
"created_at": "2023-04-14T17:42:41Z",
"locations": [
{
"name": "Worldwide",
"woeid": 1
}
]
}
]
}
}
}
]
}Pricing
$0.01per successful request
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Related endpoints
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.
X APIX data APIget trends near a location (beta) APIAI agents data APIX APIX data APIX for AI agents