Skip to content
Docs

List a profile's posts

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

GETapi.lempile.com/users/{identifier}/posts

An X profile's newest posts, reposts left out. It comes in one page: a cursor answers 400 errors/invalid_parameters, and the answer's cursor is always null; an empty list means no post showed within 25 seconds.

Scope: accounts.read.

Authentication

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

Path parameters

  • identifierstringrequired

    The X handle (with or without @).

Query parameters

  • account_idstringrequired

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

  • limitinteger

    Default 20, at most 100.

    Default20≥ 1 · ≤ 100

Responses

200

Posts.

›

application/json

  • objectany
    AlwaysPostList
  • providerany
    AlwaysX
  • querystring
  • itemsarray of Post
    ›Show fields
    • objectany
      AlwaysPost
    • providerany
      AlwaysX
    • idstring
    • authorstring
    • author_detailsAuthorDetails
      ›Show fields
      • idstring
      • public_identifierstring
      • profile_urlstring
      • profile_picture_urlstring
    • datestring · date-time
    • textstring
    • share_urlstring
    • reply_counterinteger
    • comment_counterinteger
    • reaction_counterinteger
    • repost_counterinteger
    • quote_counterinteger | null
    • bookmark_counterinteger | null
    • impressions_counterinteger | null
    • user_reactedboolean
  • cursornull
400

errors/invalid_parameters: a cursor (X lists come in one page).

›

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/user_not_found, or the account isn't found.

›

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…

Was this page helpful?