POST
/v1/tasksAdd Tasks
Add Twitter search scraping tasks by providing search URLsAdd Twitter search results to scrape by providing search URLs from X.com (Twitter). The scraper will extract tweets matching your search query.
Headers
| Key | Value | Required |
|---|---|---|
| Authorization | Token YOUR_API_KEY | Yes |
| Content-Type | application/json | Yes |
Request Body
squid
Type:
string
Required:
Yes
Description:
Hash of your squid configured with the Twitter Search Results Scraper
tasks
Type:
array
Required:
Yes
Description:
Array of task objects, each containing a `url` field
Task Object
url
Type:
string
Required:
Yes
Description:
Twitter search URL (e.g., `https://x.com/search?q=keyword&src=typed_query&f=top`)
Search URL Parameters
q
Description:
Search query (URL encoded)
f=top
Description:
Show top results
f=live
Description:
Show latest results
f=user
Description:
Show people results
f=image
Description:
Show image results
f=video
Description:
Show video results
Pro Tip
Perform your search on Twitter/X first, apply filters, then copy the URL to preserve all search parameters.
Pro Tip
Use `f=live` to get the most recent tweets matching your query.
Note
Advanced search operators like `from:username`, `since:2024-01-01`, and `filter:media` are supported in the query.