Skip to content
Docs

List the account's own posts

Early access. Tell us what you're building and we'll set you up. Contact us

GETapi.lempile.com/users/me/posts

The account's own posts, replies or reposts, newest first, from its profile's tabs: what a rebrand deletes (DELETE /posts/{post_id}) or undoes (POST /posts/repost with undo: true and the item's reposted_id). X's own data first; when it can't be had, the tab itself, read while it's scrolled like a person. Nothing is clicked. On a LinkedIn account this is /users/{identifier}/posts.

Scope: accounts.read.

Authentication

X-API-KEY header·A Lempile API key, made in the dashboard under Access tokens.

Query parameters

  • account_idstringrequired

    The connected X account: its Lempile id, its X user id, or its handle.

  • kindstring

    posts (the Posts tab: the account's posts, the pinned one marked pinned), replies (the Replies tab: its replies, each with in_reply_to) or reposts (each with reposted_id).

    One ofpostsrepliesrepostsDefaultposts
  • limitinteger

    1–100, default 20.

    Default20≥ 1 · ≤ 100
  • cursorstring

    The previous page's cursor. It still works once you deleted the post it names: the page goes on from the older ones.

    Pattern^[0-9]{1,25}$

Responses

200

The items, and the next page's cursor (null at the end).

›

application/json

  • objectany
    AlwaysOwnPostList
  • providerany
    AlwaysX
  • account_idstring
  • kindstring
    One ofpostsrepliesreposts
  • itemsarray of OwnPost
    ›Show fields
    • objectany
      AlwaysOwnPost
    • idstring

      The post, reply or repost itself (a repost's own id).

    • kindstring
      One ofpostreplyrepost
    • textstring

      Its words; a repost's are the reposted post's.

    • created_atstring · date-time | null
    • reposted_idstring

      A repost: the post it reposted, which POST /posts/repost with undo: true takes.

    • in_reply_tostring

      A reply: the post it answers.

    • pinnedany

      The profile's pinned post (first page only).

      Alwaystrue
  • cursorstring | null

    Pass it back as cursor for the next page; null at the end.

400

errors/missing_parameters or errors/invalid_parameters: a kind, limit or cursor it doesn't take.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

401

Missing or invalid API key ({error, message}), errors/disconnected_account, or errors/reauth_required when X is signed out in the account's browser.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

402

subscription_required: the workspace has no active trial or subscription.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

404

errors/resource_not_found: no such account in this workspace, or it isn't an X account.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

422

errors/timeline_not_loaded: the profile showed neither posts nor its empty notice (never an empty list), or errors/x_app_not_loaded.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

423

errors/x_account_locked: X shows the account its lock page (x.com/account/access). Nothing was done; someone has to pass X's check.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

503

errors/service_unavailable (the account isn't ready, or the browser runner can't be reached), errors/no_client_session, or errors/maintenance with retry_at.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

504

errors/timeout: nothing was changed; try again.

›

application/problem+json

  • typestringrequired
  • titlestring
  • statusintegerrequired
  • detailstring
  • retry_atstring · date-time
  • codestring

    The browser's own reason, when it refused before the click: replies_limited, post_not_accepted, gif_not_found, browser_busy…

Was this page helpful?