Public post lookup
Use X endpoints to turn public post lookup into repeatable API requests with documented inputs and JSON responses.
X (formerly known as Twitter)
Turn public X post and profile data into structured JSON for social listening, creator research, and public-interest monitoring.
Fetch public X posts, profiles, and first-page profile posts through documented Crawlora API endpoints.
Endpoint families
2
Documented params
8
Examples
3
Live catalog snapshot
Active endpoints
3
Methods
GET
Required params
6
Schema refs
3
{
"platform": "X",
"endpoint": "x-post",
"method": "GET",
"path": "/x/post/{id}",
"auth": "apiKey"
}Use cases
Fetch public X posts, profiles, and first-page profile posts through documented Crawlora API endpoints.
Use X endpoints to turn public post lookup into repeatable API requests with documented inputs and JSON responses.
Use X endpoints to turn profile enrichment into repeatable API requests with documented inputs and JSON responses.
Use X endpoints to turn first-page profile post monitoring into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live X endpoint catalog — 3 endpoints, 8 documented request parameters, and 3 published response schemas — the same catalog Docs and Playground run against.
3 documented X endpoints, grouped into 2 request families — Profile and Post.
8 request parameters are documented across those X endpoints, 6 of them required — the full input contract is public before you write any integration code.
3 of the 3 X endpoints ship a recorded example response, and 3 carry a documented response schema — you can code against the real JSON before the first request.
X endpoints document their error responses (400, 404 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
3 hosted MCP tools back the X endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/x/profile/{username}
/x/post/{id}
Endpoint catalog
/x/post/{id}Returns a public X post by numeric post id, including author, text, visible metrics, and a quoted post preview when present.
Response notes
- Returns 404 when the post is not public or the optional `username` does not match the post author. - Returns 503 when X does not provide the public page payload or the payload shape is not parseable. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "2071148560779976947", "url": "https://x.com/Ansel_Flipradio/status/2071148560779976947", "text": "Example public post text", "author": { "id": "1634026666518519808", "username": "Ansel_Flipradio", "name": "Fear_Nation_世界苦茶", "url": "https://x.com/Ansel_Flipradio" }, "metrics": { "replies": 12, "reposts": 5, "likes": 62, "bookmarks": 4, "views": 15115 } } } ```
MCP tool x_post
/x/profile/{username}Returns public profile details for an X username, including visible counts and profile media when available.
Response notes
- Returns 404 when the profile is not public or the returned profile does not match the requested username. - Returns 503 when X does not provide the public page payload or the payload shape is not parseable. - `verified_type` distinguishes the flavor of the checkmark (e.g. `Business`, `Government`) and is only present for gold/grey verified accounts; ordinary blue-verified accounts omit it. - `affiliate_label` is the small highlighted-affiliation badge X shows next to the display name (e.g. `Prime Video`) and is only present when the account has one. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "1634026666518519808", "username": "Ansel_Flipradio", "name": "Fear_Nation_世界苦茶", "url": "https://x.com/Ansel_Flipradio", "avatar_url": "https://pbs.twimg.com/profile_images/example_normal.jpg", "banner_url": "https://pbs.twimg.com/profile_banners/example/banner", "is_blue_verified": true, "verified_type": "Business", "affiliate_label": "Prime Video", "description": "Public profile description", "external_url": "https://example.com", "metrics": { "followers": 39608, "following": 188, "posts": 5498 } } } ```
MCP tool x_profile
/x/profile/{username}/postsReturns posts present in the first public profile page payload for an X username. The endpoint does not paginate replies, media-only tabs, or search results.
Response notes
- Returns only posts available in the initial public profile page payload. - Returns 404 when the profile is not public or the returned profile does not match the requested username. - Returns 503 when X does not provide the public page payload or the payload shape is not parseable. Example response: ```json { "code": 200, "msg": "OK", "data": { "username": "Ansel_Flipradio", "url": "https://x.com/Ansel_Flipradio", "count": 1, "posts": [ { "id": "1860888559739343022", "url": "https://x.com/Ansel_Flipradio/status/1860888559739343022", "text": "Example public profile post text", "author": { "id": "1634026666518519808", "username": "Ansel_Flipradio", "name": "Fear_Nation_世界苦茶", "url": "https://x.com/Ansel_Flipradio" } } ] } } ```
MCP tool x_profile_posts
Related APIs
Social & Creator Platforms
Build creator intelligence, video research, transcript, and audience-comment workflows without maintaining YouTube scrapers.
Social & Creator Platforms
Turn Twitch's public channel, stream, clip, and team data into structured JSON — live status and viewer counts, top games, clips, VODs, and team rosters — as normalized JSON. Credential-free.
Social & Creator Platforms
Track creator, content, hashtag, music, trend, and public ad creative signals from TikTok with production-ready API routes.
How to scrape X
X public pages are rendered for interactive browsing, not simple JSON export. Crawlora's X endpoints return public post and profile data as structured JSON.
A public post URL/status ID, a username, or a profile's first visible post page.
Pass the post ID and optional username, or the profile username, to Crawlora's X endpoint.
Receive post text, author context, profile counts, verification state, and visible timeline items where available.
Re-run to refresh public post details or profile-level signals for research and monitoring.
FAQ
Send a public X post ID or username to Crawlora's X endpoint and get structured JSON for public posts, profiles, or the first visible profile posts page. Collect public data and respect X's terms.
Yes — Crawlora's X endpoints target public web pages and do not require your account cookies, OAuth token, or login state.
Collecting publicly accessible post and profile data is generally permissible if you respect X's terms of use, robots directives, rate limits, and applicable law. This is for public data you're authorized to collect.
X's official API is tiered and expensive: Free allows one tweet lookup every 15 minutes, Basic ($100/month) caps out at 10,000 tweets and 7 days of search history, and full-archive access needs the Pro ($5,000/month) or Enterprise (from $42,000/month) tier. Crawlora reads the same public posts and profiles without a developer app, approval, or tier.