Posts to X this period
Posts to X this period (posts:read)
Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.
Posts to X are metered: each plan includes a number per month and bought bundles add more (used after the included ones, oldest first, expiring at the end of the billing period). A post or thread reply counts once when it is published (a post with a live link counts 14: X bills it at $0.20 against $0.015).
AuthorizationBearer <token>API key (stk_...), or in the Community Edition the access token (stk_local_...)
This period's posts to X
application/json- response
period*stringThe month the included posts count in
period_end*stringWhen the included posts reset
unlimited*booleanNo allowance applies (the Community Edition)
included*integerPosts to X the plan includes per month (-1 = unlimited)
used*integerPosts counted this month (included, bought and any overage)
included_left*integercredits_left*integerBought posts not used yet
credits_expire_at*|When the soonest bought posts expire
left*integerincluded_left + credits_left
bundles*array<>currency*stringISO 4217 code of the bundle prices, lower case
link_post_weight*integerHow many posts a post with a live link counts as
curl -X GET 'https://staqly.example.com/v1/billing/x-posts'{ "period": "2026-10", "period_end": "string", "unlimited": true, "included": 450, "used": 0, "included_left": 0, "credits_left": 0, "credits_expire_at": "string", "left": 0, "bundles": [ { "posts": 1000, "price": 40 } ], "currency": "eur", "link_post_weight": 14}