X API endpoint
Returns 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.
/x/profile/{username}/postsMCP tool: x_profile_posts
Path parameters:
username: required. X username, with or without a leading @.Query parameters:
limit: optional. Maximum posts returned from the first page payload. Defaults to 20 and must be from 1 to 50.Notable response behavior:
| Field | Filled in, of 5 checked | Values in the sample |
|---|---|---|
| id | 5 | |
| url | 5 | x.com |
| text | 5 | median 639 characters |
| created_at | 5 | 2026-09-30 to 2026-10-07 |
| author | 5 | |
| metrics | 5 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| username (path) | string | Yes | X username | Ansel_Flipradio | |
| limit | integer | No | 20 and must be 1-50 | Maximum posts returned from the first page payload. Defaults to 20 and must be 1-50. | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/x/profile/Ansel_Flipradio/posts?limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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"
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/x.profilePostsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | x.ProfilePosts | No | ||||
| data.count | integer | No | ||||
| data.posts | array | No | Post record, 33 fields: author, created_at, id, metrics, quoted, text, url. Described under Retrieve an X post API. | |||
| data.url | string | No | ||||
| data.username | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 404 | Profile not found | #/definitions/app.Response |
| 503 | Upstream error or parser drift | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/x/profile/Ansel_Flipradio/posts?limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"