Skip to content
Social

X Post Replies

Up to 20 replies to an X post, with each replier's bio and follower count.

POST/v1/x-post-replies
15 credits / postBulk supportedNewX (Twitter)
Request
curl -X POST https://api.1lookup.dev/v1/x-post-replies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/northwindcoffee/status/1800000000000000000"}'
Response
{
  "success": true,
  "data": {
    "post_url": "https://x.com/northwindcoffee/status/1800000000000000000",
    "post_id": "1800000000000000000",
    "replies": [
      {
        "id": "1800000000000000101",
        "text": "Is the Ethiopian available as a subscription or only as one-off bags?",
        "posted_at": "2026-11-10T16:22:00Z",
        "author": {
          "handle": "jordanavery_ex",
          "display_name": "Jordan Avery",
          "bio": "Cafe owner in Austin. Always testing new roasters.",
          "followers": 1840
        }
      },
      {
        "id": "1800000000000000102",
        "text": "Ordered the sampler last month and the citrus one was my favorite.",
        "posted_at": "2026-11-10T17:03:00Z",
        "author": {
          "handle": "priyaraman_ex",
          "display_name": "Priya Raman",
          "bio": "Food writer. Coffee, bread and the places that make them.",
          "followers": 22300
        }
      },
      {
        "id": "1800000000000000103",
        "text": "Do you wholesale to offices?",
        "posted_at": "2026-11-10T18:47:00Z",
        "author": {
          "handle": "marcusbell_ex",
          "display_name": "Marcus Bell",
          "bio": "Office manager at Fabrikam Health.",
          "followers": 265
        }
      }
    ]
  },
  "meta": {
    "credits_used": 15,
    "credits_remaining": 999,
    "cached": false,
    "request_id": "req_8f3a2c1e9b7d"
  }
}

Authorization

Authorizationstring<bearer>required

Your API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.

Body

Send the fields as a JSON object with Content-Type: application/json.

urlstring<uri>required

Post URL. Example: https://x.com/northwindcoffee/status/1800000000000000000

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your own identifier, echoed back in meta and shown in lookup history.

Response

A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.

successboolean

true when the lookup ran.

data.post_urlstring

The post the replies belong to.

data.replies[].textvalue

What the replier wrote.

data.replies[].posted_atvalue

When the reply was posted.

data.replies[].author.handlevalue

The X handle of the person or brand that replied.

data.replies[].author.display_namevalue

The display name on the replier's profile.

data.replies[].author.biovalue

The replier's profile bio, which often states a role, company or interest.

data.replies[].author.followersvalue

How many followers the replier has.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote this when you contact support.

Errors

A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn upstream source did not answer in time. Safe to retry.

Billing

15 credits / post. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.

Product overview and use cases