Twitter / X
Query public users, posts, communities and trends.
Advanced Search
Search X posts by keyword or query with X's advanced search operators, sorted by Latest (default) or Top. This is the primary entry point for X content research when you do not yet have tweet IDs or handles. Supports operators in the query string such as from:, to:, since:, until:, min_faves:, and -filter:replies. Cursor-paginated; returns tweets with has_next_page and next_cursor. To search accounts rather than posts use get_twitter_user_search. To read one account's own posts use get_twitter_user_tweet_timeline.
- Тип: stringqueryобязательно
The query to search for.
- Тип: string enumquery
Type обязательноThe query type to search for.
значения- Latest
- Top
- Тип: stringcursor
The cursor to paginate through the results. First page is empty.
- Тип: object · AdvancedSearchResponse200
Successful response
- Тип: booleanhas
_next _page - Тип: stringnext
_cursor - Тип: array object[] · Tweet[]tweets
- authorТип: object · User
- automatedТип: string
By - canТип: boolean
Dm - coverТип: string
Picture - createdТип: string
At - descriptionТип: string
- favouritesТип: integer
Count Integer numbers.
- followersТип: integer
Integer numbers.
- followingТип: integer
Integer numbers.
- hasТип: boolean
Custom Timelines - idТип: string
- isТип: boolean
Automated - isТип: boolean
Blue Verified - isТип: boolean
Translator - locationТип: string
- mediaТип: integer
Count Integer numbers.
- messageТип: string
- nameТип: string
- pinnedТип: array string[]
Tweet Ids - possiblyТип: boolean
Sensitive - profileТип: object
_bio - descriptionТип: string
- entitiesТип: object
- descriptionТип: object
- urlsТип: array object[]
- displayТип: string
_url - expandedТип: string
_url - indicesТип: array integer[]
- urlТип: string
- urlТип: object
- urlsТип: array object[]
- displayТип: string
_url - expandedТип: string
_url - indicesТип: array integer[]
- urlТип: string
- profileТип: string
Picture - statusesТип: integer
Count Integer numbers.
- typeТип: string
- unavailableТип: boolean
- unavailableТип: string
Reason - urlТип: string
- userТип: string
Name - verifiedТип: string
Type - withheldТип: array string[]
In Countries
- bookmarkТип: integer
Count Integer numbers.
- conversationТип: string
Id - createdТип: string
At - displayТип: array integer[]
Text Range - entitiesТип: object
- hashtagsТип: array object[]
- indicesТип: array integer[]
- textТип: string
- urlsТип: array object[]
- displayТип: string
_url - expandedТип: string
_url - indicesТип: array integer[]
- urlТип: string
- userТип: array object[]
_mentions - idТип: string
_str - nameТип: string
- screenТип: string
_name
- idТип: string
- inТип: string
Reply To Id - inТип: string
Reply To User Id - inТип: string
Reply To Username - isТип: boolean
Limited Reply - isТип: boolean
Reply - langТип: string
- likeТип: integer
Count Integer numbers.
- quoteТип: integer
Count Integer numbers.
- quotedТип: string
_tweet - replyТип: integer
Count Integer numbers.
- retweetТип: integer
Count Integer numbers.
- retweetedТип: string
_tweet - sourceТип: string
- textТип: string
- typeТип: string
- urlТип: string
- viewТип: integer
Count Integer numbers.
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/twitter/tweet/advanced_search?query=&queryType=Latest' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"tweets": [
{
"type": "string",
"id": "string",
"url": "string",
"text": "string",
"source": "string",
"retweetCount": 1,
"replyCount": 1,
"likeCount": 1,
"quoteCount": 1,
"viewCount": 1,
"createdAt": "string",
"lang": "string",
"bookmarkCount": 1,
"isReply": true,
"inReplyToId": "string",
"conversationId": "string",
"displayTextRange": [
1
],
"inReplyToUserId": "string",
"inReplyToUsername": "string",
"author": {
"type": "string",
"userName": "string",
"url": "string",
"id": "string",
"name": "string",
"isBlueVerified": true,
"verifiedType": "string",
"profilePicture": "string",
"coverPicture": "string",
"description": "string",
"location": "string",
"followers": 1,
"following": 1,
"canDm": true,
"createdAt": "string",
"favouritesCount": 1,
"hasCustomTimelines": true,
"isTranslator": true,
"mediaCount": 1,
"statusesCount": 1,
"withheldInCountries": [
"string"
],
"possiblySensitive": true,
"pinnedTweetIds": [
"string"
],
"isAutomated": true,
"automatedBy": "string",
"unavailable": true,
"message": "string",
"unavailableReason": "string",
"profile_bio": {
"description": "string",
"entities": {
"description": {
"urls": [
{
"display_url": "string",
"expanded_url": "string",
"indices": [
1
],
"url": "string"
}
]
},
"url": {
"urls": [
{
"display_url": "string",
"expanded_url": "string",
"indices": [
1
],
"url": "string"
}
]
}
}
}
},
"entities": {
"hashtags": [
{
"indices": [
1
],
"text": "string"
}
],
"urls": [
{
"display_url": "string",
"expanded_url": "string",
"indices": [
1
],
"url": "string"
}
],
"user_mentions": [
{
"id_str": "string",
"name": "string",
"screen_name": "string"
}
]
},
"quoted_tweet": "string",
"retweeted_tweet": "string",
"isLimitedReply": true
}
],
"has_next_page": true,
"next_cursor": "string"
}