Skip to main content
POST
/
api
/
twitter
/
search
/
posts
/twitter/search/posts
curl --request POST \
  --url https://api.anysite.io/api/twitter/search/posts \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 123,
  "timeout": 300,
  "query": "",
  "exact_phrase": "",
  "any_of_these_words": [
    "crypto",
    "bitcoin",
    "ethereum"
  ],
  "none_of_these_words": [
    "scam",
    "fake"
  ],
  "these_hashtags": [
    "crypto",
    "bitcoin"
  ],
  "language": "English",
  "from_these_accounts": [
    "CoinDesk",
    "X"
  ],
  "to_these_accounts": [
    "CoinDesk",
    "X"
  ],
  "mentioning_these_accounts": [
    "@CoinDesk",
    "@X"
  ],
  "min_replies": 10,
  "min_likes": 100,
  "min_retweets": 50,
  "from_date": 1672531200,
  "to_date": 1704067200,
  "search_type": "Top"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "text": "<string>",
    "@type": "@twitter_post",
    "created_at": 123,
    "user": {
      "rest_id": "<string>",
      "name": "<string>",
      "alias": "<string>",
      "url": "<string>",
      "@type": "@twitter_post_user",
      "image": "<string>",
      "verified": false,
      "verified_type": "<string>",
      "is_blue_verified": false
    },
    "retweet_count": 0,
    "favorite_count": 0,
    "reply_count": 0,
    "quote_count": 0,
    "view_count": "<string>",
    "is_retweet": false,
    "retweeted": null,
    "is_quote": false,
    "quoted": null,
    "in_reply_to_status_id": "<string>",
    "in_reply_to_user_id": "<string>",
    "in_reply_to_screen_name": "<string>",
    "lang": "<string>",
    "source": "<string>",
    "possibly_sensitive": false,
    "medias": [],
    "urls": [],
    "hashtags": [],
    "user_mentions": [],
    "card": {
      "@type": "@twitter_card_info",
      "title": "<string>",
      "description": "<string>",
      "domain": "<string>",
      "vanity_url": "<string>",
      "image_url": "<string>",
      "url": "<string>",
      "card_type": "<string>"
    },
    "poll": {
      "@type": "@twitter_poll",
      "choices": [],
      "ended_at": 123,
      "duration_minutes": 0,
      "is_final": false,
      "last_updated_at": 123
    }
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max result count

Example:

20

​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
query
string
default:""

Main search query. Can include special operators like from:user, to:user, #hashtag, etc.

Example:

"crypto bitcoin"

​
exact_phrase
string
default:""

Exact phrase (in quotes). Will be added as "phrase" to the query.

Example:

"btc trend"

​
any_of_these_words
string[] | null

Any of these words (OR condition)

Example:
["crypto", "bitcoin", "ethereum"]
​
none_of_these_words
string[] | null

None of these words (NOT condition)

Example:
["scam", "fake"]
​
these_hashtags
string[] | null

These hashtags

Example:
["crypto", "bitcoin"]
​
language
enum<string> | null

Language of tweets

Available options:
Arabic,
Arabic (Feminine),
Bangla,
Basque,
Bulgarian,
Catalan,
Croatian,
Czech,
Danish,
Dutch,
English,
Finnish,
French,
German,
Greek,
Gujarati,
Hebrew,
Hindi,
Hungarian,
Indonesian,
Italian,
Japanese,
Kannada,
Korean,
Marathi,
Norwegian,
Persian,
Polish,
Portuguese,
Romanian,
Russian,
Serbian,
Simplified Chinese,
Slovak,
Spanish,
Swedish,
Tamil,
Thai,
Traditional Chinese,
Turkish,
Ukrainian,
Urdu,
Vietnamese
Example:

"English"

​
from_these_accounts
string[] | null

From these accounts

Example:
["CoinDesk", "X"]
​
to_these_accounts
string[] | null

To these accounts

Example:
["CoinDesk", "X"]
​
mentioning_these_accounts
string[] | null

Mentioning these accounts (username with @)

Example:
["@CoinDesk", "@X"]
​
min_replies
integer | null

Minimum number of replies

Example:

10

​
min_likes
integer | null

Minimum number of likes

Example:

100

​
min_retweets
integer | null

Minimum number of retweets

Example:

50

​
from_date
integer | null

Starting date for tweets search. Accepts timestamp

Required range: x > 1136073600
Example:

1672531200

​
to_date
integer | null

Ending date for tweets search. Accepts timestamp

Required range: x > 1136073600
Example:

1704067200

​
search_type
enum<string>
default:Top

Type of search results

Available options:
Top,
Latest
Examples:

"Top"

"Latest"

Response

Successful Response

​
id
string
required
​
url
string
required
​
text
string
required
​
@type
string
default:@twitter_post
​
created_at
integer | null
​
user
TwitterPostUser · object
​
retweet_count
integer
default:0
​
favorite_count
integer
default:0
​
reply_count
integer
default:0
​
quote_count
integer
default:0
​
view_count
string | null
​
is_retweet
boolean
default:false
​
retweeted
unknown
​
is_quote
boolean
default:false
​
quoted
unknown
​
in_reply_to_status_id
string | null
​
in_reply_to_user_id
string | null
​
in_reply_to_screen_name
string | null
​
lang
string | null
​
source
string | null
​
possibly_sensitive
boolean
default:false
​
medias
TwitterMedia · object[]
​
urls
TwitterUrl · object[]
​
hashtags
TwitterHashtag · object[]
​
user_mentions
TwitterPostUserMention · object[]
​
card
TwitterCardInfo · object
​
poll
TwitterPoll · object