Start an async job to search and scrape tweets. Returns a `jobId` immediately — poll `GET /twitter/tweet-scraper/scrape/…
Authentication
No API key — create one in the dashboard
Body
Twitter (X) URLs to scrape. Tweet, Profile, Search, or List URLs are supported. Max 25 entries.
Search terms to query on Twitter (X). Supports advanced search operators. Max 25 entries.
Twitter handles whose tweets you want to retrieve (without @). Max 25 entries.
Conversation IDs (numeric tweet IDs) whose threads you want to retrieve. Max 25 entries.
Maximum number of tweets to return (1–500). Determines credits reserved upfront. Defaults to 100.
Sort order. 'Latest + Top' runs both simultaneously to maximise results but may include duplicates.
Restrict results to tweets in this language (ISO 639-1 code).
Return only tweets from verified (blue-check) accounts.
Return only tweets from Twitter Blue subscribers.
Return only tweets that contain images.
Return only tweets that contain videos.
Return only quote tweets.
Return only tweets sent by this handle (e.g. "MichelLieben", without @).
Return only tweets that are replies to this handle.
Return only tweets mentioning this handle.
Return only tweets geotagged near this location (e.g. "New York, NY").
Restrict geo results to within this radius (e.g. "15mi"). Use together with geotaggedNear.
Return tweets from users within radius of latitude/longitude (e.g. "48.8566,2.3522,10km").
Return only tweets tagged with this place ID.
Return only tweets with at least this many retweets.
Return only tweets with at least this many likes.
Return only tweets with at least this many replies.
Return only tweets sent after this date (YYYY-MM-DD).
Return only tweets sent before this date (YYYY-MM-DD).
Add a searchTerm field to each tweet indicating the search term that matched it.
import requests url = "https://api.coldiq.com/v1/twitter/tweet-scraper/scrape" headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, headers=headers) print(response.json())