SocialFetch
Search X posts or people by query.
Offering
- Provider
- api.socialfetch.dev
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Social Intelligence
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.socialfetch.dev/v1/twitter/search- MIME type
- application/json
- First seen
- 2026-10-16T01:50:14.534Z
- Last seen
- Tags
- Twitter, social-data
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.014 USDC
Atomic price: 14000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "14000",
"payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043"
}
]Observed health
- Status
- Healthy
- Latest latency
- 39 ms
- Average latency
- 553 ms
- HTTP status
- 402
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET"
]
},
"queryParams": {
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 512,
"description": "Search query for public posts on X. Supported post-type operators include `include:nativeretweets`, `filter:nativeretweets`, and `filter:retweets`; `is:retweet` is not supported."
},
"section": {
"default": "top",
"description": "Search section: `top` (default), `latest`, `people`, `photos`, or `videos`.",
"type": "string",
"enum": [
"top",
"latest",
"people",
"photos",
"videos"
]
},
"minRetweets": {
"description": "Optional minimum retweet count filter.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"minLikes": {
"description": "Optional minimum like count filter.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"minReplies": {
"description": "Optional minimum reply count filter.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Optional page size (1–20). Requests cannot ask for more than 20 posts; the actual page size may be smaller. Use the response cursor for subsequent pages.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"startDate": {
"description": "Optional start date filter in YYYY-MM-DD format.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"endDate": {
"description": "Optional end date filter in YYYY-MM-DD format.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"language": {
"description": "Optional language filter.",
"type": "string",
"enum": [
"en",
"es",
"fr",
"de",
"it",
"pt",
"ru",
"zh",
"ja",
"ko",
"ar",
"bg",
"hr",
"cs",
"da",
"nl",
"et",
"fi",
"el",
"hu",
"id",
"ga",
"lv",
"lt",
"no",
"pl",
"ro",
"sk",
"sl",
"sv",
"tr",
"uk",
"vi",
"cy",
"zu"
]
},
"cursor": {
"description": "Opaque pagination cursor returned by a previous response.",
"type": "string",
"minLength": 1
}
},
"required": [
"query"
]
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"cursor": {
"description": "Opaque pagination cursor returned by a previous response.",
"minLength": 1,
"type": "string"
},
"endDate": {
"description": "Optional end date filter in YYYY-MM-DD format.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"language": {
"description": "Optional language filter.",
"enum": [
"en",
"es",
"fr",
"de",
"it",
"pt",
"ru",
"zh",
"ja",
"ko",
"ar",
"bg",
"hr",
"cs",
"da",
"nl",
"et",
"fi",
"el",
"hu",
"id",
"ga",
"lv",
"lt",
"no",
"pl",
"ro",
"sk",
"sl",
"sv",
"tr",
"uk",
"vi",
"cy",
"zu"
],
"type": "string"
},
"limit": {
"description": "Optional page size (1–20). Requests cannot ask for more than 20 posts; the actual page size may be smaller. Use the response cursor for subsequent pages.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"minLikes": {
"description": "Optional minimum like count filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"minReplies": {
"description": "Optional minimum reply count filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"minRetweets": {
"description": "Optional minimum retweet count filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Search query for public posts on X. Supported post-type operators include `include:nativeretweets`, `filter:nativeretweets`, and `filter:retweets`; `is:retweet` is not supported.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"section": {
"default": "top",
"description": "Search section: `top` (default), `latest`, `people`, `photos`, or `videos`.",
"enum": [
"top",
"latest",
"people",
"photos",
"videos"
],
"type": "string"
},
"startDate": {
"description": "Optional start date filter in YYYY-MM-DD format.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}