twitter-search is for a question that comes back. Save the query for a brand, topic, or phrase. On the next check, send the same query, language, and max_results values so the response is comparable to the earlier one.

The route returns recent public post text, timestamps, engagement metrics, and author details. It converts since:, until:, and -filter:retweets into the current X API query parameters before it makes a read-only request.

If X cannot answer, the result stays honest. The response keeps its tweets array, sets degraded: true, and labels the public-index fallback. Use that result for a current lead. Require a non-degraded response when native X metrics or full author expansion matter.

The request fields, response shape, price, and read-only boundary are unchanged. This is clearer catalog and MCP copy for agents that return to the same monitoring question.