X (Twitter) research
Look up public X profiles, recent posts, and individual post content/engagement
— all as normalized JSON from the Crawlora API, no browser automation or
official X API access required.
When to use this skill
- "What's 's profile / follower count on X?"
- "Pull 's recent posts on X."
- "What does this X post say, and what's its engagement?"
- Competitor or influencer social-listening on X without X API access.
Setup (one-time)
- Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
- Set
CRAWLORA_API_KEY in the environment before running the helper.
- The helper reads
CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.
How it works
- Profile —
GET /x/profile/{username} returns public profile details
for an X username, including visible counts and profile media when
available.
- Profile posts —
GET /x/profile/{username}/posts returns posts from
the first public profile page payload (defaults to 20, max 50 via
limit). It does not paginate replies, media-only tabs, or search
results.
- Post detail —
GET /x/post/{id} returns a single public post by
numeric post id, including author, text, visible metrics, and a quoted
post preview when present. Pass username to require the author match
(mismatches return 404).
Full endpoint list, methods, and params: reference/endpoints.md.
Calling the API
# Profile:
scripts/crawlora.sh /x/profile/nasa | jq '.'
# Profile posts (capped at 50 per page):
scripts/crawlora.sh /x/profile/nasa/posts limit=30 | jq '.'
# Single post, with author check:
scripts/crawlora.sh /x/post/1234567890 username=nasa | jq '.'
Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.
Endpoint reference
See reference/endpoints.md for all X endpoints
this skill uses.
Examples
- Profile snapshot:
/x/profile/<handle> for follower/following counts
and bio before deciding whether an account is worth tracking.
- Recent activity check:
/x/profile/<handle>/posts to see posting
cadence and topics without paging into replies or media tabs.
- Single post lookup:
/x/post/<id> to pull a specific post's text and
metrics, e.g. from a link shared elsewhere, optionally verifying the
author with username=.
Notes & limits
- Credits / pay-on-success: billed only on
2xx; free tier 2,000 credits/mo.
Key at https://crawlora.net.
- Public data only — public profiles/posts; no login, no private content.
Respect X's terms.
- Security: key lives in
CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
- No search or trending on X — this skill only covers profile, profile
posts, and post detail; there is no
/x/search or trending endpoint.
- Profile posts is single-page, not cursor-paginated —
/x/profile/{username}/posts
only returns what's in the first page payload (limit 1-50, default 20);
it won't walk further back in a timeline.
- Post lookup is by numeric id only —
/x/post/{id} needs the post's
numeric id, not a tweet URL slug or username; pass username to guard
against id collisions/mismatches.
1---2name: x-research3description: Researches X (formerly Twitter) profiles and posts via the Crawlora API, returning clean JSON. Use when the user wants a public X profile's stats, a user's recent posts, or a single post's content/engagement — instead of scraping x.com or using the official (paid, rate-limited) X API.4---56# X (Twitter) research78Look up public X profiles, recent posts, and individual post content/engagement9— all as normalized JSON from the Crawlora API, no browser automation or10official X API access required.1112## When to use this skill1314- "What's <handle>'s profile / follower count on X?"15- "Pull <handle>'s recent posts on X."16- "What does this X post say, and what's its engagement?"17- Competitor or influencer social-listening on X without X API access.1819## Setup (one-time)2021- Get a free Crawlora API key (2,000 credits/mo, no card) at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).22- Set `CRAWLORA_API_KEY` in the environment before running the helper.23- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`. Missing/invalid key → `401`.2425## How it works26271. **Profile** — `GET /x/profile/{username}` returns public profile details28 for an X username, including visible counts and profile media when29 available.302. **Profile posts** — `GET /x/profile/{username}/posts` returns posts from31 the first public profile page payload (defaults to 20, max 50 via32 `limit`). It does not paginate replies, media-only tabs, or search33 results.343. **Post detail** — `GET /x/post/{id}` returns a single public post by35 numeric post id, including author, text, visible metrics, and a quoted36 post preview when present. Pass `username` to require the author match37 (mismatches return 404).3839Full endpoint list, methods, and params: [`reference/endpoints.md`](reference/endpoints.md).4041## Calling the API4243```sh44# Profile:45scripts/crawlora.sh /x/profile/nasa | jq '.'4647# Profile posts (capped at 50 per page):48scripts/crawlora.sh /x/profile/nasa/posts limit=30 | jq '.'4950# Single post, with author check:51scripts/crawlora.sh /x/post/1234567890 username=nasa | jq '.'52```5354Use `scripts/crawlora.sh` for all requests; it keeps the API key out of command-line arguments.555657## Endpoint reference5859See [`reference/endpoints.md`](reference/endpoints.md) for all X endpoints60this skill uses.6162## Examples6364- **Profile snapshot:** `/x/profile/<handle>` for follower/following counts65 and bio before deciding whether an account is worth tracking.66- **Recent activity check:** `/x/profile/<handle>/posts` to see posting67 cadence and topics without paging into replies or media tabs.68- **Single post lookup:** `/x/post/<id>` to pull a specific post's text and69 metrics, e.g. from a link shared elsewhere, optionally verifying the70 author with `username=`.7172## Notes & limits7374- **Credits / pay-on-success:** billed only on `2xx`; free tier 2,000 credits/mo.75 Key at [https://crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).76- **Public data only** — public profiles/posts; no login, no private content.77 Respect X's terms.78- **Security:** key lives in `CRAWLORA_API_KEY` only — never hardcode, query-param, or commit it.79- **No search or trending on X** — this skill only covers profile, profile80 posts, and post detail; there is no `/x/search` or trending endpoint.81- **Profile posts is single-page, not cursor-paginated** — `/x/profile/{username}/posts`82 only returns what's in the first page payload (`limit` 1-50, default 20);83 it won't walk further back in a timeline.84- **Post lookup is by numeric id only** — `/x/post/{id}` needs the post's85 numeric id, not a tweet URL slug or username; pass `username` to guard86 against id collisions/mismatches.
Crawlora-org