> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # User tweets > Fetches a public profile (`https://x.com/`) and returns the user's tweets in display order (pinned first, then newest → oldest). Strictly tweet details — no user/author objects. Returns the most recent tweets (one page, no pagination). Set `trim=true` for a lightweight response. **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). ```text Prompt I want to make an API call to /v1/twitter/user-tweets. Here are the details: Endpoint: GET https://api.scraperize.com/v1/twitter/user-tweets Description: Fetches a public profile (`https://x.com/`) and returns the user's tweets in display order (pinned first, then newest → oldest). Strictly tweet details — no user/author objects. Returns the most recent tweets (one page, no pagination). Set `trim=true` for a lightweight response. Required Headers: - x-api-key: Your API key Parameters: - handle (string) [required]: User handle WITHOUT the @ symbol, e.g. `thedankoe`. - trim (select): Return trimmed-down tweets (essential fields only). - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. Example Response: { "data": { "tweets": [ { "id": "2010751592346030461", "url": "https://x.com/thedankoe/status/2010751592346030461", "text": "https://t.co/7l7Jef99QZ", "isLongForm": false, "lang": "zxx", "createdAtMs": 1768235512000, "createdAt": "2026-01-12T16:31:52.000Z", "counts": { "likes": 357792, "retweets": 57448, "replies": 9317, "quotes": 15941, "bookmarks": 940591 }, "views": "246051197", "media": [], "mentions": [], "urls": [ { "url": "https://t.co/7l7Jef99QZ", "expandedUrl": "http://x.com/i/article/2010742786430021632", "displayUrl": "x.com/i/article/2010…" } ], "hashtags": [], "cashtags": [], "card": { "id": "Q2FyZDpodHRwczovL3QuY28vN2w3SmVmOTlRWg==" }, "communityNote": null, "article": { "id": "2010742786430021632", "title": "How to fix your entire life in 1 day", "previewText": "If you're anything like me, you think new years resolutions are stupid.\nBecause most people go about changing their lives in the completely wrong way. They crea…", "coverImage": { "url": "https://pbs.twimg.com/media/G-efypCbQAEEi8a.jpg", "width": 1456, "height": 582 }, "fullText": null, "raw": { "article_results": { "id": "QXJ0aWNsZUVudGl0eVJlc3VsdHM6MjAxMDc0Mjc4NjQzMDAyMTYzMg==", "result": { "__isArticleResult": "ArticleEntity", "cover_media_results": { "id": "QXBpTWVkaWFSZXN1bHRzOgwABQoAARvnn8qQm0ABCgACAAAAAA9KOzAAAA==", "result": { "id": "QXBpTWVkaWE6DAAFCgABG+efypCbQAEKAAIAAAAAD0o7MAAA", "media_info": { "original_img_height": 582, "original_img_url": "https://pbs.twimg.com/media/G-efypCbQAEEi8a.jpg", "original_img_width": 1456 } } }, "id": "QXJ0aWNsZUVudGl0eToyMDEwNzQyNzg2NDMwMDIxNjMy", "preview_text": "If you're anything like me, you think new years resolutions are stupid.\nBecause most people go about changing their lives in the completely wrong way. They crea…", "rest_id": "2010742786430021632", "title": "How to fix your entire life in 1 day" } } } }, "isReply": false, "replyToTweetId": null, "replyToUserId": null, "isQuote": false, "quotedTweetId": null, "quotedTweet": null, "possiblySensitive": false, "conversationControl": null, "editTweetIds": [ "2010751592346030461" ], "place": null, "isPinned": true } ], "tweetCount": 5, "fetchedAt": "2026-10-05T14:42:27.369Z" }, "meta": { "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", "creditsCharged": 1, "creditsRemaining": 4999, "cached": false } } Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/twitter/user-tweets openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints paths: /v1/twitter/user-tweets: get: tags: - Twitter summary: User tweets description: >- Fetches a public profile (`https://x.com/`) and returns the user's tweets in display order (pinned first, then newest → oldest). Strictly tweet details — no user/author objects. Returns the most recent tweets (one page, no pagination). Set `trim=true` for a lightweight response. parameters: - name: handle in: query required: true description: User handle WITHOUT the @ symbol, e.g. `thedankoe`. schema: type: string example: thedankoe - name: trim in: query required: false description: Return trimmed-down tweets (essential fields only). schema: type: boolean default: false - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The user's tweets (tweet details only). content: application/json: schema: type: object properties: data: type: object properties: tweets: type: array items: type: object tweetCount: type: integer fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: tweets: - id: '2010751592346030461' url: https://x.com/thedankoe/status/2010751592346030461 text: https://t.co/7l7Jef99QZ isLongForm: false lang: zxx createdAtMs: 1768235512000 createdAt: '2026-01-12T16:31:52.000Z' counts: likes: 357792 retweets: 57448 replies: 9317 quotes: 15941 bookmarks: 940591 views: '246051197' media: [] mentions: [] urls: - url: https://t.co/7l7Jef99QZ expandedUrl: http://x.com/i/article/2010742786430021632 displayUrl: x.com/i/article/2010… hashtags: [] cashtags: [] card: id: Q2FyZDpodHRwczovL3QuY28vN2w3SmVmOTlRWg== communityNote: null article: id: '2010742786430021632' title: How to fix your entire life in 1 day previewText: >- If you're anything like me, you think new years resolutions are stupid. Because most people go about changing their lives in the completely wrong way. They create these resolutions because everyone coverImage: url: https://pbs.twimg.com/media/G-efypCbQAEEi8a.jpg width: 1456 height: 582 fullText: null raw: article_results: id: >- QXJ0aWNsZUVudGl0eVJlc3VsdHM6MjAxMDc0Mjc4NjQzMDAyMTYzMg== result: __isArticleResult: ArticleEntity cover_media_results: id: >- QXBpTWVkaWFSZXN1bHRzOgwABQoAARvnn8qQm0ABCgACAAAAAA9KOzAAAA== result: id: >- QXBpTWVkaWE6DAAFCgABG+efypCbQAEKAAIAAAAAD0o7MAAA media_info: original_img_height: 582 original_img_url: >- https://pbs.twimg.com/media/G-efypCbQAEEi8a.jpg original_img_width: 1456 id: QXJ0aWNsZUVudGl0eToyMDEwNzQyNzg2NDMwMDIxNjMy preview_text: >- If you're anything like me, you think new years resolutions are stupid. Because most people go about changing their lives in the completely wrong way. They create these resolutions because everyone rest_id: '2010742786430021632' title: How to fix your entire life in 1 day isReply: false replyToTweetId: null replyToUserId: null isQuote: false quotedTweetId: null quotedTweet: null possiblySensitive: false conversationControl: null editTweetIds: - '2010751592346030461' place: null isPinned: true - id: '2107097241290695165' url: https://x.com/thedankoe/status/2107097241290695165 text: >- If you get addicted to things easily, good, your problem is aim. Point that same obsession at a skill, your body, or your work for 2 years and people will start calling you "disciplined" instead. isLongForm: false lang: en createdAtMs: 1791206104000 createdAt: '2026-10-05T13:15:04.000Z' counts: likes: 1425 retweets: 122 replies: 82 quotes: 9 bookmarks: 297 views: '31371' media: [] mentions: [] urls: [] hashtags: [] cashtags: [] card: null communityNote: null article: null isReply: false replyToTweetId: null replyToUserId: null isQuote: false quotedTweetId: null quotedTweet: null conversationControl: null editTweetIds: - '2107097241290695165' place: null isPinned: false - id: '2106788829189271668' url: https://x.com/thedankoe/status/2106788829189271668 text: >- Pick a challenge too big for who you are now. That's how people change. A challenge above your level drags the new version of you out. It will suck. You'll fail constantly. You'll feel like a fraud for months. Your old self will beg you to stay the same. But if you can pull this off, 10-20 times throughout your life, you will blow past everyone else. isLongForm: true lang: en createdAtMs: 1791132573000 createdAt: '2026-10-04T16:49:33.000Z' counts: likes: 7156 retweets: 974 replies: 231 quotes: 98 bookmarks: 3185 views: '196726' media: [] mentions: [] urls: [] hashtags: [] cashtags: [] card: null communityNote: null article: null isReply: false replyToTweetId: null replyToUserId: null isQuote: false quotedTweetId: null quotedTweet: null conversationControl: null editTweetIds: - '2106788829189271668' place: null isPinned: false tweetCount: 5 fetchedAt: '2026-10-05T14:42:27.369Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: Handle not found / suspended / no profile data. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: Required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.