API Reference

X (Twitter) API

Access X (formerly Twitter) data including tweets, users, followers, and search for AI Agents

Version
1.0.0
Endpoints
38

Base URL

https://api.pressmonitor.com/x/v1

Authentication

All requests use Bearer token authentication. Add the Authorization header to every call.

Authorization: Bearer YOUR_TOKEN
GET /autocomplete

Autocomplete

Autocomplete

Parameters

Name Type Location Required Description
value string query Yes Value
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/autocomplete?value=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /comments

Comments

Comments

Parameters

Name Type Location Required Description
pid string query Yes Pid
ranking_mode string query Yes Ranking mode
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/comments?pid=SOME_STRING_VALUE&ranking_mode=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /community-topics

Community Topics

Community Topics

Parameters

Name Type Location Required Description
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/community-topics?count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /community-tweets

Community Tweets

Community Tweets

Parameters

Name Type Location Required Description
communityId string query Yes Community Id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/community-tweets?communityId=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /fetch-popular-communities

Fetch Popular Communities

Fetch Popular Communities

Parameters

Name Type Location Required Description
topicId string query Yes Topic Id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/fetch-popular-communities?topicId=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /followers

Followers

Followers

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/followers?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /followers-ids

Followers I Ds

Followers I Ds

Parameters

Name Type Location Required Description
username string query Yes Username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/followers-ids?username=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /followings

Followings

Followings

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/followings?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /followings-ids

Followings I Ds

Followings I Ds

Parameters

Name Type Location Required Description
username string query Yes Username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/followings-ids?username=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /get-users

Get Users

Get Users

Parameters

Name Type Location Required Description
users string query Yes Users
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/get-users?users=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /group-tweets

Group Tweets

Group Tweets

Parameters

Name Type Location Required Description
communityId string query Yes Community Id
rankingMode string query Yes Ranking Mode
searchType string query Yes Search Type
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/group-tweets?communityId=SOME_STRING_VALUE&rankingMode=SOME_STRING_VALUE&searchType=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /highlights

Highlights

Highlights

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/highlights?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /jobs-details

Jobs Details

Jobs Details

Parameters

Name Type Location Required Description
jobId string query Yes Job Id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/jobs-details?jobId=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /jobs-locations-suggest

Jobs Locations Suggest

Jobs Locations Suggest

Parameters

Name Type Location Required Description
query string query Yes Search query
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/jobs-locations-suggest?query=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /jobs-search

Jobs Search

Jobs Search

Parameters

Name Type Location Required Description
employment_type string query Yes Employment type
job_location_id string query Yes Job location id
job_location_type string query Yes Job location type
keyword string query Yes Keyword
seniority_level string query Yes Seniority level
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/jobs-search?employment_type=SOME_STRING_VALUE&job_location_id=SOME_STRING_VALUE&job_location_type=SOME_STRING_VALUE&keyword=SOME_STRING_VALUE&seniority_level=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /likes

Likes

Likes

Parameters

Name Type Location Required Description
pid string query Yes Pid
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/likes?pid=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /list-details

List Details

List Details

Parameters

Name Type Location Required Description
listId string query Yes List Id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/list-details?listId=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /list-timeline

List Timeline

List Timeline

Parameters

Name Type Location Required Description
listId string query Yes List Id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/list-timeline?listId=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /list-tweets

List Tweets

List Tweets

Parameters

Name Type Location Required Description
list_id string query Yes List id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/list-tweets?list_id=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /org-affiliates

Org Affiliates

Org Affiliates

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/org-affiliates?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /quotes

Quotes

Quotes

Parameters

Name Type Location Required Description
pid string query Yes Pid
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/quotes?pid=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /retweets

Retweets

Retweets

Parameters

Name Type Location Required Description
pid string query Yes Pid
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/retweets?pid=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /search-community

Search Community

Search Community

Parameters

Name Type Location Required Description
query string query Yes Search query
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/search-community?query=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /search-lists

Search Lists

Search Lists

Parameters

Name Type Location Required Description
query string query Yes Search query
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/search-lists?query=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /searchold

Searchold

Searchold

Parameters

Name Type Location Required Description
query string query Yes Search query
type string query Yes Type
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/searchold?query=SOME_STRING_VALUE&type=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /spaces

Spaces

Spaces

Parameters

Name Type Location Required Description
id string query Yes Id
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/spaces?id=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /trends-locations

Trends Locations

Trends Locations

Parameters

Name Type Location Required Description
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/trends-locations?count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /tweet

Tweet

Tweet

Parameters

Name Type Location Required Description
pid string query Yes Pid
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/tweet?pid=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /tweet-by-ids

Tweet By Ids

Tweet By Ids

Parameters

Name Type Location Required Description
tweetIDs string query Yes Tweet I Ds
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/tweet-by-ids?tweetIDs=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /user

User

User

Parameters

Name Type Location Required Description
username string query Yes Username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/user?username=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /user-likes

User Likes

User Likes

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/user-likes?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /user-media

User Media

User Media

Parameters

Name Type Location Required Description
cusor string query Yes Cusor
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/user-media?cusor=SOME_STRING_VALUE&user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /user-replies

User Replies

User Replies

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/user-replies?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /user-replies-v2

User Replies V2

User Replies V2

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/user-replies-v2?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /user-tweets

User Tweets

User Tweets

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/user-tweets?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success
GET /verified-followers

Verified Followers

Verified Followers

Parameters

Name Type Location Required Description
user string query Yes User
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl --request GET \ --url 'https://api.pressmonitor.com/x/v1/verified-followers?user=SOME_STRING_VALUE&count=SOME_INTEGER_VALUE&cursor=SOME_INTEGER_VALUE'

Responses

200 Success