Press Monitor X / Twitter Search API
Onboarding Instructions
The Press Monitor Advanced Twitter/X Search API provides programmatic access to search, tweet lookup, user profiles, and network graph endpoints (followers, followings), with pagination cursors and enterprise-ready JSON. Ideal for brand monitoring, influencer discovery, social listening, and AI/analytics pipelines.
Base URL & OpenAPI Schema
Base Endpoint:
https://api.pressmonitor.com/x/v1
OpenAPI Schema: Download Schema
Authentication
All endpoints require Bearer Token authentication:
Authorization: Bearer YOUR_TOKEN
Each request deducts credits based on content type. Credits and request IDs are returned in responses for usage tracking.
Endpoints Overview
- GET /search — advanced search across Tweets, Photos/Media, People, Latest, and Lists
- GET /tweet — retrieve a Tweet by ID (rich engagement + media)
- GET /user — lookup a user by username
- GET /followers — followers of a user (paginated)
- GET /followings — accounts a user follows (paginated)
- GET /user-tweets — recent tweets by a user (paginated)
- GET /get-users — bulk lookup by user IDs (comma-separated)
- GET /verified-followers — only verified followers (paginated)
Parameters by Endpoint
/search
- query (required) — search term/keyword
- type (required) —
Top | Photos | Media | People | Latest | Lists - count (optional) — page size (endpoint max applies)
- cursor (optional) — pagination cursor from previous page
/tweet
- pid (required) — tweet ID
/user
- username (required) — screen name without
@
/followers, /followings, /user-tweets, /verified-followers
- user (required) — target user ID (
rest_id) - count (optional) — page size
- cursor (optional) — pagination
/get-users
- users (required) — comma-separated user IDs
Response Shape (summary)
Most list endpoints return an array of objects. Pagination support is provided via a cursor parameter (request) and may be surfaced as next_cursor in responses.
Example Requests
Search (Latest)
curl -s "https://api.pressmonitor.com/x/v1/search?query=AI%20models&type=Top&count=20" -H "Authorization: Bearer YOUR_TOKEN"
Tweet by ID
curl -s "https://api.pressmonitor.com/x/v1/tweet?pid=1964395588927000801" -H "Authorization: Bearer YOUR_TOKEN"
Followers (paginated)
curl -s "https://api.pressmonitor.com/x/v1/followers?user=2455740283&count=50&cursor=NEXT_CURSOR" -H "Authorization: Bearer YOUR_TOKEN"
Bulk Users
curl -s "https://api.pressmonitor.com/x/v1/get-users?users=44196397,2455740283" -H "Authorization: Bearer YOUR_TOKEN"
Best Practices
- Use cursor to page large result sets efficiently.
- Respect endpoint count maximums to avoid throttling.
- Cache non-volatile lookups (e.g., user profile by ID).
- Log
request_id(if present) for support/usage tracing.
Support
Docs & Guides: https://www.pressmonitor.com/en/docs/twitter-x-api Email: support@pressmonitor.com