A search result is better than a blank call

twitter-search looks for recent public posts and returns post text, timestamps, author details, and public metrics. Send a query, then add language or max_results when the job needs them.

The endpoint accepts common older Twitter-search syntax too. It converts since: and until: into the X API's time parameters, and maps -filter:retweets to the current exclusion operator. Unsupported legacy filters are removed and reported in the response rather than being passed upstream as a paid 400.

If X API access cannot answer the request, twitter-search returns a labeled public-index fallback in the same tweets array. The response sets degraded: true, names x-api as the dependency, and includes the upstream status so an agent can decide how to use the result.