Twitter / X
Query public users, posts, communities and trends.
Search User by Keyword
Search X user accounts by keyword and get back matching profiles. Use this when you know roughly who you are looking for — a company name, a topic, a partial handle — but not the exact @handle. Cursor-paginated; returns full user objects under users. This searches accounts, not posts; to search tweet content use get_twitter_tweet_advanced_search.
- 型: stringquery必須
The keyword to search.
- 型: stringcursor
The cursor to paginate through the results. First page is empty.
- 型: object · SearchUserResponse200
Successful response
- 型: booleanhas
_next _page - 型: stringmsg
- 型: stringnext
_cursor - 型: string 列挙値status値
- success
- error
- 型: array object[] · User[]users
- 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
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/search?query=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"users": [
{
"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"
}
]
}
}
}
}
],
"has_next_page": true,
"next_cursor": "string",
"status": "success",
"msg": "string"
}