What format is the data returned in?

Responses are JSON. Each one contains the extracted data plus a _metadata block with the request ID and execution time.

What are the rate limits for the X (Twitter) Search API?

Up to 60 requests per minute, 1,000 per hour and 10,000 per day. Contact us if you need higher limits.

Can I run long requests in the background?

Yes. Add ?async=true to receive a job_id immediately, then poll /api/v1/jobs/ / until the status is COMPLETED.

Can I send a large list of requests at once?

Yes. Upload a CSV file with one request per row and the X (Twitter) Search API runs them in the background within 24 hours, at 50% of the normal price for each successful row. Use "Upload file" in the Playground or add ?batch=true to the API call.

Do I need to manage proxies or browsers?

No. DataGuru runs the infrastructure, proxies and retries. You only send an HTTP request with your API key.

Social Media API · Live

X (Twitter) Search API

Search X (Twitter) posts and accounts by keyword or query.

No credit card required · Pay only for what you use

Price: $0.001 / req
Rate limit: 60 req/min
Output: Structured JSON
Modes: Sync & async

POSThttps://api.dataguru.cc/api/v1/x/search

curl -X POST "https://api.dataguru.cc/api/v1/x/search" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": "5", "query": "example"}'

Response · 200 OK

{
  "x_search": {
    "query": "string",
    "search_url": "https://example.com/...",
    "total_results": 0,
    "results": [
      {
        "post_id": "1234567890",
        "post_url": "https://example.com/...",
        "author_username": "string",
        "author_name": "string",
        "author_id": "1234567890",
        "author_profile_image": "string",
        "text": "string",
        "embedded_hashtags": [
          "string"
        ],
        "create_time": "string",
        "reply_count": 0,
        "retweet_count": 0,
        "like_count": 0,
        "quote_count": 0,
        "view_count": 0,
        "save_count": 0,
        "is_retweet": false,
        "is_pinned": false
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "X (Twitter) Search",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Data

X (Twitter) Search API response (structured JSON)

Every response follows the same schema, so you can map it once and rely on it.

Response fields

querysearch_urltotal_resultsresults

Request parameters

Name	Type	Description
limit	integer	Maximum number of search results to return (1-50).
queryrequired	string	Search query or topic, e.g. "openai" or "AI".

Features

X (Twitter) Search API features that make scraping easy

No proxies or blocks to manage

DataGuru handles proxies, retries and anti-bot measures for you. You just send a request.

Clean, structured JSON

Every response uses the same 4 fields, so your parser never breaks.

One simple request

Send query and get results back. No browser automation or HTML parsing on your side.

Sync or async

Get the data in the response, or add ?async=true and poll the job for long-running requests.

Built to scale

Up to 60 requests per minute and 10,000 per day on this endpoint.

Pay only for what you use

No subscription or monthly minimum. Usage is deducted from your prepaid balance.

Use cases

What you can build with the X (Twitter) Search API

Influencer discovery

Find creators by audience, topic and engagement to build better campaigns.

Brand monitoring

Follow mentions and conversations about your brand as they happen.

Audience research

Understand who engages with you and your competitors.

Lead enrichment

Add public profile details to the leads already in your CRM.

Trend analysis

Spot rising topics and formats before they peak.

Competitor benchmarking

Compare follower growth and engagement against competitors.

Who it's for

Built for teams of every size and background

Social media managers
Influencer agencies
Brand teams
Sales & RevOps teams
Market researchers
Recruiters
Data engineers
Analytics startups

Get started

Start using the X (Twitter) Search API in minutes

1
Create a free account
Sign up in seconds and get $1.00 of free balance to test with.
2
Copy your API key
Generate a key in the Developer Portal and send it in the Authorization header.
3
Send a request
Call POST /api/v1/x/search with your parameters.
4
Get structured JSON
Use the response straight away in your app, spreadsheet or pipeline.

Pricing

Transparent & simple pricing

No subscription, no monthly minimum. Add funds to your balance and pay only for the requests you make.

Pay as you go

X (Twitter) Search

$0.001 / req

$1.00 free balance on sign-up
60 requests per minute
10,000 requests per day
Sync and async requests

FAQ

Frequently asked questions

The X (Twitter) Search API costs $0.001 per successful request, deducted from your prepaid balance. There is no subscription or monthly minimum. New accounts get $1.00 of free balance to try it.

More APIs

Other APIs you might need

Social Media

Try the X (Twitter) Search API for free!

Create an account and get $1.00 of free balance to test it. No credit card required.