Twitter / X
Query public users, posts, communities and trends.
Get User Mentions
Get tweets that mention a given @handle, 20 per page. This is the only user-scoped X endpoint that supports a time window: pass sinceTime and/or untilTime as Unix timestamps in seconds to bound the range. Use this for monitoring — brand mentions, inbound replies, reputation tracking, or 'what happened to this account in the last 24 hours'. Returns tweets with has_next_page and next_cursor. For the account's own posts rather than mentions of it, use get_twitter_user_tweet_timeline.
- 类型: stringuser
Name 必填The user screen name to get mentions for.
- 类型: integer 格式: int64since
Time On or after a specified unix timestamp in seconds.
- 类型: integer 格式: int64until
Time Before a specified unix timestamp in seconds.
- 类型: stringcursor
The cursor to paginate through the results. First page is empty.
- 类型: object · UserMentionsResponse200
Successful response
- 类型: integercode
Integer numbers.
- 类型: booleanhas
_next _page - 类型: stringmsg
- 类型: stringnext
_cursor - 类型: string 枚举status值
- success
- error
- 类型: 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/user/mentions?userName=' \
--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",
"status": "success",
"msg": "string",
"code": 1
}