X

Use this skill for read-only lookups of public X data: post search, post lookup, conversation replies, user lookup, and user timelines.

Call the API

• Call https://api.x.com/2/... with curl --fail-with-body --silent --show-error from the sandbox.
• Do not send an Authorization header. Junior adds the X credential to requests for this host.
• Use only GET. The deployment token is app-only, so X rejects writes.
• Pass query parameters with curl -G --data-urlencode.
• Pipe responses through jq and keep only the fields you need.

Every read costs money

The X API is pay-per-use. Each post returned costs about $0.005 and each user about $0.01. The same post read again on the same UTC day is not billed again. Keep every request small: