Renvoie une liste paginée des publications d'un créateur X depuis la base persistée, avec date de publication, légende et compteurs d'engagement. Idéal pour construire une chronologie de performance ou choisir des contenus représentatifs.
GET
/api/v1/x/user/postsConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 1 unités de quota de votre forfait.
Paramètres de requête
Paramètres obligatoires
| Nom | Emplacement | Type | Description |
|---|---|---|---|
username | query | string | X handle example: elonmusk |
Paramètres optionnels
| Nom | Emplacement | Type | Description |
|---|---|---|---|
publish_at_start | query | string | Publish time from example: 2026-01-01 |
publish_at_end | query | string | Publish time to example: 2026-09-01 |
post_id | query | string | Post ID example: 1519480761749016577 |
media_type | query | string | Media type (0 = text, 1 = image, 2 = video, 3 = GIF) example: 2 |
post_type | query | string | Post type (1 = original, 2 = repost, 3 = quote, 4 = thread, 5 = reply) example: 1 |
exclude_retweet | query | string | Exclude reposts (1 = exclude) example: 1 |
is_paid | query | string | Sponsored post (1 = yes) example: 1 |
sort_by | query | string | Sort field (publish_at, view_count, like_count, engagement_rate) example: publish_at |
sort_order | query | string | Sort direction (asc, desc), default desc example: desc |
page | query | integer | Page number |
page_size | query | integer | Page size |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
Tester
https://openapi.scdata.cc/api/v1/x/user/posts
Sélectionnez une clé API du tableau de bord
Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord
Paramètres de requête
username*publish_at_startpublish_at_endpost_idmedia_typepost_typeexclude_retweetis_paidsort_bysort_orderpagepage_sizeExemple cURL
bash
curl -X GET "https://openapi.scdata.cc/api/v1/x/user/posts?username=elonmusk" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"post_id": "1519480761749016577","post_url": "https://x.com/elonmusk/status/1519480761749016577","description": "Next I’m buying Coca-Cola to put the cocaine back in","duration": 0,"publish_at": "2022-04-28 08:56:58","language": "en","media_type": "text","post_type": "original","is_pinned": false,"is_sensitive": false,"is_paid": false,"view_count": 0,"like_count": 4198044,"comment_count": 167757,"retweet_count": 577720,"quote_count": 168195,"bookmark_count": 22534,"engagement_count": 5111716,"engagement_rate": "2.12","source": "Twitter for iPhone","post_username": "elonmusk","post_user_url": "https://x.com/elonmusk","post_user_follower_count": 241536070,"last_update_at": "2026-09-02 16:22:17"}],"total": 112,"page": 1,"page_size": 1,"total_pages": 112}}
Cas d'usage
- Bilan de performance des contenus — Comparez l'engagement des dernières publications d'un créateur pour repérer les formats et sujets qui plaisent à son audience.
- Contrôle de brand safety — Passez en revue les légendes et thèmes récents avant un partenariat pour vérifier l'adéquation avec la marque.