X Search

Searches recent public X posts, wrapping the read-only X API v2 recent-search route.

Overview

Searches recent public X posts, wrapping the read-only X API v2 recent-search route. Takes a query, excludes retweets by default, offers an optional language filter, expands author profile data, and returns public post text, timestamps, metrics, and author username/profile fields. Requires X_BEARER_TOKEN; no posting, replying, liking, following, or account mutation. Use it as an X search API, Twitter search API, recent tweet search, public posts search, or social search.

Endpoint

Method	Endpoint	Price	Description
POST	/v1/marketplace/api/x-search	$0.0115	Invoke X Search (Search) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://api.jarvisclaw.ai/v1/marketplace/api/x-search \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://api.jarvisclaw.ai/v1/marketplace/api/x-search \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'

Open in the marketplace