OmniSocialsOmniSocials
DocumentationAPI reference
Help centerSupport
  • Documentation
  • API reference
Developers
  • Quickstart
  • API reference
  • SDKs
  • MCP server
  • CLI
For AI agents
  • Docs for AI agents
  • llms.txt
  • OpenAPI spec
  • Postman collection
Product
  • OmniSocials
  • Pricing
  • Changelog
  • Help center
Company
  • Support
  • Privacy policy
  • Terms of service

© 2026 OmniSocials

OmniSocials on GitHubOmniSocials on XOmniSocials on LinkedIn
Information
Posts
    List postsgetList live platform postsgetGet a postgetDelete a postdeleteUpdate a postpatchCreate a postpostCreate and publish postpostPublish a post nowpostRetry failed postpostApprove a postpostReject a postpostGet approval reviewget
Media
    List mediagetGet a media itemgetDelete a media itemdeleteRename or move mediapatchUpload a filepostUpload from base64postUpload from a URLpostCreate an upload URLpostSplit a PDF into pagespostCheck media limitspostUpload with a tokenpost
Folders
    List foldersgetCreate a folderpostDelete a folderdeleteRename or move a folderpatch
Hashtag Sets
    List hashtag setsgetCreate a hashtag setpostGet a hashtag setgetDelete a hashtag setdeleteUpdate a hashtag setpatch
Tags
    List tagsgetCreate a tagpostDelete a tagdeleteUpdate a tagpatchTag posts in bulkpost
Accounts
    List accountsgetGet an accountgetChange how often X statistics are checkedpatch
Analytics
    Get bulk post analyticsgetGet post analyticsgetCompare tagsgetGet analytics overviewgetGet account analyticsgetGet best posting timesgetCheck the X numbers of a post now ("Update now")post
Credits
    Credit balance and X statisticsget
Approvals
    List approval workflowsget
Webhooks
    List webhooksgetCreate a webhookpostGet a webhookgetDelete a webhookdeleteUpdate a webhookpatchRotate webhook secretpost
Locations
    Search locationsgetValidate a locationget
Audio
    Search Instagram audioget
Pinterest
    List product PinsgetCheck a product Pinget
Inbox
    List conversationsgetList messagesgetMark conversation readpostReply to a conversationpostHide or unhide a commentpostLike or unlike a commentpostDelete a commentdeleteGet next conversationget
Automations
    List automationsgetCreate an automationpostGet an automationgetDelete an automationdeleteUpdate an automationpatchList automation eventsget
Feature requests
    List what OmniSocials cannot dogetList your feature requestsgetSend a feature requestpostGet a feature requestget
Schemas
OmniSocials API
OmniSocials API

Credits

Download schema

The organisation's credit balance and X statistics: X bills every statistics read, and OmniSocials passes X's price on as credits.


Credit balance and X statistics

GET
https://api.omnisocials.com/v1
/credits

The organisation's credit balance (1 credit = €0.01), whether auto-refill is on, the credits used this month by type, and the X statistics overview: the state (active or paused at 0 credits), the date charging starts, each X account with its setting and its estimate for a month, and this month's reads. Needs the opt-in scope credits:read and billing rights (manage_billing) for the key's creator.

Credit balance and X statistics › Responses

The balance and the X statistics overview

No data returned
GET/credits
curl "https://api.omnisocials.com/v1/credits" \ -H "Authorization: Bearer $OMNISOCIALS_API_KEY"
Example Responses
{ "data": { "balance": 412, "auto_refill": { "enabled": false }, "this_month": { "x_statistics": 31, "x_url_post": 40, "x_dm": 6 }, "x_statistics": { "state": "active", "charging": { "active": true, "from": "2027-01-01T00:00:00.000Z" }, "total_credits_month": 38, "accounts": [ { "account_id": "1234_x", "handle": "@omnisocials", "posts": "full", "followers": "daily", "credits_month": 38 } ] } } }
json
application/json

AnalyticsApprovals