Search Tweets
Search public posts on X (Twitter) by keyword with cursor pagination. Each successful request costs 2 credits; failed requests are not billed.
Credits
Each successful response deducts 2 credits from your organization. Requests that fail (4xx / 5xx) are not billed.
See the credits documentation for the full rate table.
Authorization
bearerAuth Organization API key (sf_api_… from Integrations → API) or a partner OAuth 2.1 access token issued by SnitchFeed (authorization_code + refresh). OAuth tokens must be audience-bound to this API (resource = {apiOrigin}/v1). Every credential must carry the scope its route requires (for example search:read for /data/*); see https://snitchfeed.com/docs/api/scopes for the scope each route needs.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request body for POST /data/twitter/tweets/search.
Search keywords for posts on X.
1 <= length <= 200Opaque cursor from a previous response meta.nextCursor.
length <= 1024Maximum tweets to return (capped at 20).
1 <= value <= 2020Search tab / category on X.
Value in
- "Top"
- "Latest"
- "People"
- "Photos"
- "Videos"
Additional structured filters (subset of upstream search).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/data/twitter/tweets/search" \ -H "Content-Type: application/json" \ -d '{ "query": "string" }'{ "requestId": "string", "posts": [ { "id": "string", "body": "string", "author": "string", "name": "string", "timestamp": "string", "url": "string", "images": [ "string" ], "video": "string", "engagements": { "bookmarkCount": 0, "favoriteCount": 0, "quoteCount": 0, "replyCount": 0, "retweetCount": 0, "viewsCount": 0 } } ], "meta": { "returnedCount": 0, "hasMore": true, "nextCursor": "string" }}Webhooks
SnitchFeed webhook events and payload, the 10-second timeout, retries with exponential backoff, per-destination pacing and securing unsigned calls.
Search LinkedIn industries GET
Look up LinkedIn industry IDs by name for the author_industry filter on LinkedIn post search. Paginated, read-only, and free of credits. Returns matching industries with their numeric ID, label, and hierarchy path. Use the returned `id` values as the `author_industry` filter when calling `POST /data/linkedin/posts/search`. **Read-only:** this endpoint does not consume credits.