LoginSign Up
PlatformMCPAPI
Twitter

Search Tweets

Search public posts on X (Twitter).

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.

POST
/data/twitter/tweets/search

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key (sf_api_… from Integrations → API keys) 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) and carry the route scopes listed per operation.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for POST /data/twitter/tweets/search.

query*string

Search keywords for posts on X.

Length1 <= length <= 200
cursor?string

Opaque cursor from a previous response meta.nextCursor.

Lengthlength <= 1024
count?integer

Maximum tweets to return (capped at 20).

Range1 <= value <= 20
Default20
category?string

Search tab / category on X.

Value in

  • "Top"
  • "Latest"
  • "People"
  • "Photos"
  • "Videos"
filters?

Additional structured filters (subset of upstream search).

Response Body

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"  }}

OAuth

Authorize an integration to access a customer's SnitchFeed organization with OAuth 2.0 instead of an API key, including scopes and token refresh.

Search LinkedIn industries GET

Search LinkedIn industry codes by name or category. 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.