/search/searchSearch
Search
Cost / request
$0.01
Response format
JSON
Protocol
REST
About this endpoint
Access X data through agntdata: Search. This endpoint return search results. 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 |
|---|---|---|---|---|
| limit | query | number | optional | —Default: 5 |
| language | query | string | optional | —Default: en |
| start_date | query | string | optional | YYYY-MM-DDDefault: 2022-01-01 |
| min_likes | query | number | optional | —Default: 1 |
| min_retweets | query | number | optional | —Default: 1 |
| query | query | string | required | —Default: #python |
| end_date | query | string | optional | — |
| min_replies | query | number | optional | — |
| section | query | string | optional | —Default: top |
Responses
Response
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tweet_id": {
"type": "string"
},
"creation_date": {
"type": "string"
},
"text": {
"type": "string"
},
"media_url": {
"type": "null"
},
"user": {
"type": "object"
},
"language": {
"type": "string"
},
"favorite_count": {
"type": "integer"
},
"retweet_count": {
"type": "integer"
},
"reply_count": {
"type": "integer"
},
"quote_count": {
"type": "integer"
},
"retweet": {
"type": "boolean"
},
"timestamp": {
"type": "integer"
}
}
}
},
"continuation_token": {
"type": "string"
}
}
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "Search_get__search_search",
"method": "get",
"path": "/search/search",
"summary": "Search",
"description": "This endpoint return search results",
"parameters": [
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "number",
"default": "5"
}
},
{
"name": "language",
"in": "query",
"required": false,
"schema": {
"type": "string",
"default": "en"
}
},
{
"name": "start_date",
"in": "query",
"required": false,
"schema": {
"type": "string",
"default": "2022-01-01"
},
"description": "YYYY-MM-DD"
},
{
"name": "min_likes",
"in": "query",
"required": false,
"schema": {
"type": "number",
"default": "1"
}
},
{
"name": "min_retweets",
"in": "query",
"required": false,
"schema": {
"type": "number",
"default": "1"
}
},
{
"name": "query",
"in": "query",
"required": true,
"schema": {
"type": "string",
"default": "#python"
}
},
{
"name": "end_date",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "min_replies",
"in": "query",
"required": false,
"schema": {
"type": "number"
}
},
{
"name": "section",
"in": "query",
"required": false,
"schema": {
"type": "string",
"default": "top"
}
}
],
"responses": [
{
"statusCode": "200",
"description": "Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tweet_id": {
"type": "string"
},
"creation_date": {
"type": "string"
},
"text": {
"type": "string"
},
"media_url": {
"type": "null"
},
"user": {
"type": "object"
},
"language": {
"type": "string"
},
"favorite_count": {
"type": "integer"
},
"retweet_count": {
"type": "integer"
},
"reply_count": {
"type": "integer"
},
"quote_count": {
"type": "integer"
},
"retweet": {
"type": "boolean"
},
"timestamp": {
"type": "integer"
}
}
}
},
"continuation_token": {
"type": "string"
}
}
},
"example": {
"results": [
{
"tweet_id": "1637273433322188800",
"creation_date": "Sun Mar 19 02:03:00 +0000 2023",
"text": "How to Track Location using IP Address with Python | Location Tracking using Python\n#python \nhttps://t.co/NGaR9WWl8p",
"media_url": [],
"video_url": null,
"user": {
"creation_date": "Fri Apr 21 11:36:02 +0000 2017",
"user_id": "855384627975831553",
"username": "PythonPr",
"name": "Python Programming",
"follower_count": 53120,
"following_count": 1253,
"favourites_count": 3798,
"is_private": false,
"is_verified": false,
"is_blue_verified": false,
"location": "United States",
"profile_pic_url": "https://pbs.twimg.com/profile_images/855386134439895041/BKOMdcnN_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/855384627975831553/1492774829",
"description": "#python #programming",
"external_url": "https://morioh.com",
"number_of_tweets": 4461,
"bot": false,
"timestamp": 1492774562,
"has_nft_avatar": false
},
"language": "en",
"favorite_count": 737,
"retweet_count": 182,
"reply_count": 5,
"quote_count": 4,
"retweet": false,
"views": null,
"timestamp": 1679191380,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": null,
"binding_values": null,
"expanded_url": "https://morioh.com/p/7890474d46e4?f=5c21fb01c16e2556b555ab32"
},
{
"tweet_id": "1637323009919791106",
"creation_date": "Sun Mar 19 05:20:00 +0000 2023",
"text": "Build an Automated Excel Bot in Python on Windows\n#python #excel \n https://t.co/Qsv04dhQ20",
"media_url": [],
"video_url": null,
"user": {
"creation_date": "Fri Jun 17 12:22:15 +0000 2016",
"user_id": "743780794997547008",
"username": "Python_Dv",
"name": "Python Developer",
"follower_count": 24941,
"following_count": 1069,
"favourites_count": 3099,
"is_private": false,
"is_verified": false,
"is_blue_verified": false,
"location": "United States",
"profile_pic_url": "https://pbs.twimg.com/profile_images/842358957997883392/59-UQhVS_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/743780794997547008/1489669161",
"description": "#python #programming #developers,#django",
"external_url": "http://morioh.com",
"number_of_tweets": 3959,
"bot": false,
"timestamp": 1466166135,
"has_nft_avatar": false
},
"language": "en",
"favorite_count": 402,
"retweet_count": 86,
"reply_count": 4,
"quote_count": 3,
"retweet": false,
"views": null,
"timestamp": 1679203200,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": null,
"binding_values": null,
"expanded_url": "https://morioh.com/p/1c247d4094da?f=5ece19cf823ab46e1ec20d78"
},
{
"tweet_id": "1637597318768631809",
"creation_date": "Sun Mar 19 23:30:00 +0000 2023",
"text": "Create a Python app to simplify Excel Data Entry (Full Tutorial)\n#python \n https://t.co/6S1MTFyJzR",
"media_url": [],
"video_url": null,
"user": {
"creation_date": "Fri Apr 21 11:36:02 +0000 2017",
"user_id": "855384627975831553",
"username": "PythonPr",
"name": "Python Programming",
"follower_count": 53120,
"following_count": 1253,
"favourites_count": 3798,
"is_private": false,
"is_verified": false,
"is_blue_verified": false,
"location": "United States",
"profile_pic_url": "https://pbs.twimg.com/profile_images/855386134439895041/BKOMdcnN_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/855384627975831553/1492774829",
"description": "#python #programming",
"external_url": "https://morioh.com",
"number_of_tweets": 4461,
"bot": false,
"timestamp": 1492774562,
"has_nft_avatar": false
},
"language": "en",
"favorite_count": 206,
"retweet_count": 59,
"reply_count": 1,
"quote_count": 0,
"retweet": false,
"views": null,
"timestamp": 1679268600,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": null,
"binding_values": null,
"expanded_url": "https://morioh.com/p/502a78294d6a?f=5c21fb01c16e2556b555ab32"
},
{
"tweet_id": "1637630634289139712",
"creation_date": "Mon Mar 20 01:42:23 +0000 2023",
"text": "Building a WhatsApp Chatbot with Python, Twilio, and EC2: Introducing ChatGPT WhatsApp Bot\n#python #Chatbot\nhttps://t.co/fLxmcFEL6e",
"media_url": [],
"video_url": null,
"user": {
"creation_date": "Fri Jun 17 12:22:15 +0000 2016",
"user_id": "743780794997547008",
"username": "Python_Dv",
"name": "Python Developer",
"follower_count": 24941,
"following_count": 1069,
"favourites_count": 3099,
"is_private": false,
"is_verified": false,
"is_blue_verified": false,
"location": "United States",
"profile_pic_url": "https://pbs.twimg.com/profile_images/842358957997883392/59-UQhVS_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/743780794997547008/1489669161",
"description": "#python #programming #developers,#django",
"external_url": "http://morioh.com",
"number_of_tweets": 3959,
"bot": false,
"timestamp": 1466166135,
"has_nft_avatar": false
},
"language": "en",
"favorite_count": 196,
"retweet_count": 64,
"reply_count": 3,
"quote_count": 0,
"retweet": false,
"views": null,
"timestamp": 1679276543,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": null,
"binding_values": null,
"expanded_url": "https://morioh.com/p/9dc1088732c3?f=5c21fb01c16e2556b555ab32"
},
{
"tweet_id": "1636784209774755840",
"creation_date": "Fri Mar 17 17:39:00 +0000 2023",
"text": "Colombian rivers! Coloured according to their drainage basin, and scaled by discharge. #SouthAmerica #Colombia #Rivers #DrainageBasin #Python #Geography #DataViz https://t.co/wpPQ7mkg4D",
"media_url": [
"https://pbs.twimg.com/media/FrVm7nyXsAIG5W7.jpg"
],
"video_url": null,
"user": {
"creation_date": "Tue Jan 12 21:46:11 +0000 2021",
"user_id": "1349110409215795204",
"username": "PythonMaps",
"name": "Python Maps",
"follower_count": 36712,
"following_count": 537,
"favourites_count": 3741,
"is_private": false,
"is_verified": false,
"is_blue_verified": false,
"location": "Planet Earth",
"profile_pic_url": "https://pbs.twimg.com/profile_images/1562542823869759488/g9scogmy_normal.jpg",
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1349110409215795204/1676751697",
"description": "Mapping the world with Python. Geospatial data scientist who likes maps. \nContact info@pythonmaps.com \nBuy our maps: https://t.co/Zm2HsOT6Lb",
"external_url": "http://pythonmaps.com",
"number_of_tweets": 1184,
"bot": false,
"timestamp": 1610487971,
"has_nft_avatar": false
},
"language": "en",
"favorite_count": 5779,
"retweet_count": 1165,
"reply_count": 33,
"quote_count": 51,
"retweet": false,
"views": null,
"timestamp": 1679074740,
"video_view_count": null,
"in_reply_to_status_id": null,
"quoted_status_id": null,
"binding_values": null,
"expanded_url": "https://twitter.com/PythonMaps/status/1636784209774755840/photo/1"
}
],
"continuation_token": "scroll:thGAVUV0VFVBYBFoD4ysWS3JC5LRIYPBJjwusAAAH0P4BiTdLxqfwAAAAFFrjDg1FacAAWueoVxlYgARa3BpEVl8AAFroIYqYaEAAWuPCaRNewAmEViIh6FYCJehgEVVNFUjUKFQAVAAA="
}
}
}
},
{
"statusCode": "422",
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"title": "HTTPValidationError",
"type": "object",
"properties": {
"detail": {
"title": "Detail",
"type": "array",
"items": {
"title": "ValidationError",
"required": [
"loc",
"msg",
"type"
],
"type": "object",
"properties": {
"loc": {
"title": "Location",
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
}
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
}
}
}
}
},
"example": {
"detail": [
{
"loc": [],
"msg": "",
"type": ""
}
]
}
}
}
}
]
}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 APIsearch APIAI agents data APIX APIX data APIX for AI agents