Skip to content

X post search API for keywords and authors

Send a keyword, or from:handle to search one author. Get back up to 20 recent public X posts with their text, author, time and engagement counts. 15 credits per search.

15 credits / searchSocialMCPNew
POST/v1/x-post-search
{
  "success": true,
  "data": {
    "query": "northwind coffee",
    "posts": [
      {
        "id": "1800000000000000001",
        "url": "https://x.com/priyaraman_ex/status/1800000000000000001",
        "text": "Tried the new Northwind Coffee fall blend this morning. Bright, a little citrus, would buy again.",
        "author": {
          "handle": "priyaraman_ex",
          "display_name": "Priya Raman"
        },
        "posted_at": "2026-11-12T14:05:00Z",
        "likes": 38,
        "reposts": 4,
        "replies": 6,
        "views": 2900
      },
      {
        "id": "1800000000000000002",
        "url": "https://x.com/marcusbell_ex/status/1800000000000000002",
        "text": "Does anyone know if Northwind Coffee ships whole bean to Canada?",
        "author": {
          "handle": "marcusbell_ex",
          "display_name": "Marcus Bell"
        },
        "posted_at": "2026-11-11T19:41:00Z",
        "likes": 3,
        "reposts": 0,
        "replies": 2,
        "views": 410
      }
    ]
  },
  "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.

posts[].textPost textThe full text of the matching post.
posts[].author.handleAuthorThe handle of the account that wrote the post.
posts[].posted_atPosted atWhen the post was published, as an ISO 8601 timestamp in UTC.
posts[].likesLikesLike count at the time of the search.
posts[].repostsRepostsHow many times the post was reposted.
posts[].repliesRepliesNumber of replies under the post.
posts[].viewsViewsThe public view count X shows for the post.
posts[].urlPost URLA direct link to the post, which you can pass to X Post Replies.
[02/Capabilities]

What X Post Search does

01

Keyword and author queries

Pass a word or phrase to search public posts, or from:handle to limit the search to one account. The query goes in a single field.

02

Up to 20 recent posts per search

Each search returns up to 20 recent matching posts. It is built for seeing what is being said now, not for pulling an archive.

03

Engagement counts on each post

Posts come back with likes, reposts, replies and views as integers. Cut the noise by setting your own floor for what counts as a post worth reading.

04

IDs and URLs for follow-up

Each post includes its ID and URL. Send the URL to X Post Replies when you want to see who responded and what they said.

[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-post-search15 credits / search

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-post-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"phone validation"}'
Endpoint
POST /v1/x-post-search
Base URL
https://api.1lookup.dev
Request
query
Price
15 credits / search
Coverage
X (Twitter)
Bulk
Single requests
Cache
Repeats within 7 days are free
Also via
Dashboard and MCP server (run_lookup)
[05/Use cases]

What teams use it for

Watch a brand name

Search your company or product name on a schedule, store the posts you have not seen before, and route questions and complaints to the team that answers them.

Find people asking for what you sell

Search the phrases buyers use when they ask for a recommendation in your category. Each result gives you the post and the author's handle, so you can reply from your own account.

Read the reaction to a launch

Search a product name or campaign hashtag in the days after a release and compare engagement across the posts that mention it.

Check what one account has been saying

Use from:handle before a sales call or partnership conversation to read an account's recent posts in one response.

This product returns public X posts, and you are responsible for using them in line with X's terms and the privacy law that applies to you.

[06/Cost]

15 credits / search

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 searchs
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 Post Search questions

What can I put in the query?

A keyword, a phrase, or from:handle to return posts by one account. For example, phone validation or from:northwindcoffee.

How much does an X search cost?

15 credits per search, whether it returns one post or 20. Searches that fail on our side are not charged.

How many posts come back, and how far back do they go?

Up to 20 recent posts per search. The product returns recent public posts and is not a historical archive, so it is not the right tool for backfilling years of posts. There is no CSV bulk upload for searches.

Do I need an X developer account?

No. You call 1lookup.dev with your 1lookup.dev API key. The product reads public posts, so there is no X login or X API key to set up.

How do I keep a monitoring job from returning cached results?

Results are cached for 7 days, and a repeat of the same query in that window is free. For monitoring, pass fresh: true so each run performs a new search, which is charged as a normal search.

[ Validate ][ Enrich ]
[Get started]

Run X Post Search on your own data

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

[ Screen ][ Scrape ]