X Post Replies
Up to 20 replies to an X post, with each replier's bio and follower count.
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"}'{
"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>requiredYour 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>requiredPost URL. Example: https://x.com/northwindcoffee/status/1800000000000000000
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour 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.
successbooleantrue when the lookup ran.
data.post_urlstringThe post the replies belong to.
data.replies[].textvalueWhat the replier wrote.
data.replies[].posted_atvalueWhen the reply was posted.
data.replies[].author.handlevalueThe X handle of the person or brand that replied.
data.replies[].author.display_namevalueThe display name on the replier's profile.
data.replies[].author.biovalueThe replier's profile bio, which often states a role, company or interest.
data.replies[].author.followersvalueHow many followers the replier has.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote 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.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An 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