API

X (Twitter) API

X reaches around 600 million monthly users through short posts, live commentary, video, and breaking-news conversation, making it important for real-time communications, media visibility, and reputation response.

API Reference Version: 1.0.0 38 Endpoints Authentication
X

Base URL

https://api.pressmonitor.co.in

Authentication

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

Authorization: Bearer YOUR_API_KEY
x-subscription-id: YOUR_SUB_ID
GET /autocomplete

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/autocomplete?value=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /comments

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/comments?pid=VALUE&ranking_mode=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/community-topics" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /community-tweets

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/community-tweets?communityId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /followers

Followers

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/followers?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /followers-ids

Parameters

Name Type Location Required Description
username string query Yes Username (screen name without @ symbol, e.g., 'elonmusk')
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/followers-ids?username=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /followings

Followings

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/followings?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /followings-ids

Parameters

Name Type Location Required Description
username string query Yes Username (screen name without @ symbol, e.g., 'elonmusk')
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/followings-ids?username=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/get-users?users=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /group-tweets

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/group-tweets?communityId=VALUE&rankingMode=VALUE&searchType=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /highlights

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/highlights?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /jobs-details

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/jobs-details?jobId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/jobs-locations-suggest?query=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/likes?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /list-details

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/list-details?listId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /list-timeline

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/list-timeline?listId=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /list-tweets

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/list-tweets?list_id=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /org-affiliates

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/org-affiliates?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/quotes?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/retweets?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/search-community?query=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/search-lists?query=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/searchold?query=VALUE&type=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /spaces

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/spaces?id=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /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 -X GET "https://api.pressmonitor.co.in/tweet?pid=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /tweet-by-ids

Parameters

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

Code Examples

curl -X GET "https://api.pressmonitor.co.in/tweet-by-ids?tweetIDs=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /user

User

Parameters

Name Type Location Required Description
username string query Yes Username (screen name without @ symbol, e.g., 'elonmusk')
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/user?username=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /user-likes

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/user-likes?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /user-media

Parameters

Name Type Location Required Description
cusor string query Yes
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/user-media?cusor=VALUE&user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /user-replies

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/user-replies?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /user-replies-v2

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/user-replies-v2?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /user-tweets

User Tweets

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/user-tweets?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success
GET /verified-followers

Verified Followers

Parameters

Name Type Location Required Description
user string query Yes Numeric User ID (not username). Use 'user' endpoint to lookup ID from username
count integer query No Number of results to return
cursor integer query No Pagination cursor for next page

Code Examples

curl -X GET "https://api.pressmonitor.co.in/verified-followers?user=VALUE" -H "Authorization: Bearer YOUR_API_KEY" -H "x-subscription-id: YOUR_SUB_ID"

Responses

200 Success