Skip to content

X profile posts API for an account's latest 20 posts

Send an X handle. Get back the account's 20 most recent public posts, each with its text, time, URL and engagement counts. 15 credits per account.

15 credits / accountSocialCSV bulkMCPNew
POST/v1/x-profile-posts
{
  "success": true,
  "data": {
    "handle": "northwindcoffee",
    "profile_url": "https://x.com/northwindcoffee",
    "posts": [
      {
        "id": "1800000000000000000",
        "url": "https://x.com/northwindcoffee/status/1800000000000000000",
        "text": "Our fall lineup is live: three new single origins, roasted this week.",
        "posted_at": "2026-11-10T16:00:00Z",
        "likes": 212,
        "reposts": 31,
        "replies": 18,
        "views": 14600
      },
      {
        "id": "1799999999999999990",
        "url": "https://x.com/northwindcoffee/status/1799999999999999990",
        "text": "We are hiring a second roaster in Portland. Details on our site.",
        "posted_at": "2026-11-06T18:30:00Z",
        "likes": 64,
        "reposts": 22,
        "replies": 9,
        "views": 8100
      },
      {
        "id": "1799999999999999980",
        "url": "https://x.com/northwindcoffee/status/1799999999999999980",
        "text": "The cafe is closed on Thursday the 26th. Online orders ship Friday.",
        "posted_at": "2026-11-03T15:12:00Z",
        "likes": 27,
        "reposts": 2,
        "replies": 4,
        "views": 3900
      }
    ]
  },
  "meta": {
    "credits_used": 15,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}
[01/Response]

What you get back

The fields most teams branch on. The full response is in the sample on this page and in the API reference.

handleHandleThe account the posts belong to, as you sent it.
posts[].textPost textWhat the account posted, in full.
posts[].posted_atPosted atPublish time for each post, useful for measuring how often the account posts.
posts[].likesLikesLikes on that post when the lookup ran.
posts[].repostsRepostsRepost count for the post.
posts[].repliesRepliesHow many replies the post has drawn.
posts[].viewsViewsPublic view count for the post.
posts[].urlPost URLPermanent link to the individual post.
[02/Capabilities]

What X Profile Posts does

01

One handle in, 20 posts out

Send a handle and receive the account's latest 20 public posts. There is no query syntax to learn and nothing to page through.

02

Engagement for every post

Likes, reposts, replies and views are returned per post. Average them to get a baseline for the account, then spot the posts that beat it.

03

Timestamps that show cadence

Each post carries the time it was published. Twenty timestamps are enough to tell an account that posts daily from one that went quiet months ago.

04

Bulk for lists of accounts

This product supports CSV upload. Put your handles in one column, start a job in the dashboard or through the bulk API, and collect the results when the webhook fires.

[03/Try it]

See the response before you sign up

Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.

POST /v1/x-profile-posts15 credits / account

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

One POST request

Send JSON with a Bearer key. The same key works for all 79 products.

curl -X POST https://api.1lookup.dev/v1/x-profile-posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"northwindcoffee"}'
Endpoint
POST /v1/x-profile-posts
Base URL
https://api.1lookup.dev
Request
handle
Price
15 credits / account
Coverage
X (Twitter)
Bulk
CSV upload and bulk API
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Open outreach with something real

Before you write to a prospect, pull their recent posts and reference what they are talking about this week instead of a generic first line.

Follow competitor accounts

Run a weekly job over the accounts you track, store new posts, and see which announcements and topics drew a response.

Check a creator's recent performance

Compare engagement on the last 20 posts with the follower count from Social Profile Check to judge whether an audience is active.

Summarize an account with an LLM

Through the MCP server, an assistant can fetch an account's recent posts with run_lookup and write a short brief on what the account covers.

Posts are read from public X accounts, and it is up to you to use them in a way that complies with X's terms and applicable privacy law.

[06/Cost]

15 credits / account

Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.

See pricing
PlanPer 1,000 creditsPer 1,000 accounts
Starter $29/mo$4.83$72.50
Growth $99/mo$3.96$59.40
Pro $299/mo$3.32$49.83
Scale $799/mo$2.66$39.95
[07/FAQ]

X Profile Posts questions

What does X Profile Posts return?

The handle you asked for and its latest 20 public posts. Each post has an ID, URL, text, timestamp and counts for likes, reposts, replies and views.

How much does it cost?

15 credits per account. If the account does not exist, is suspended or is protected, there is nothing to return and you are not charged.

Can I get more than the latest 20 posts?

No. Each lookup returns the latest 20 and does not go further back. To build a longer history, run the lookup on a schedule with fresh: true and store what you receive.

Does it include follower count and bio?

Not in this product. Use Social Profile Check with platform set to x for followers, bio and the verified flag, then combine the two results.

How is this different from X Post Search with from:handle?

Both can return one account's posts. X Profile Posts takes a plain handle and supports CSV bulk upload, which suits a list of accounts. X Post Search suits workflows that mix keyword and author queries.

[ Validate ][ Enrich ]
[Get started]

Run X Profile Posts on your own data

Starter is $29 a month for 6,000 credits, enough for 400 accounts a month.

[ Screen ][ Scrape ]