> ## Documentation Index > Fetch the complete documentation index at: https://docs.superx.so/llms.txt > Use this file to discover all available pages before exploring further. # Search the inspiration library > Search a library of 50M+ real high-performing posts by topic. Use the results for structures, hooks and angles to remix, never to copy. The library is user-level, so there is no `account_id` parameter. Results are intentionally varied: the same query returns a different mix on each call. Pagination is heuristic; `has_more` means a full page came back with library pages left (pages run 1 to 7). Each result carries an `outlier_score`: the post's engagement rate vs the expected rate for its author's follower tier, x10 (10 = expected, higher = overperformed). Null when the author's follower count is unknown. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/inspiration openapi: 3.1.0 info: title: SuperX API version: 1.0.0 description: > The SuperX public API: your Twitter/X content, analytics, audience and scheduling data over REST. All endpoints require an API key (`Authorization: Bearer sxk_...`) except `GET /v1/docs`. Keys are created in the SuperX app under Account > API / MCP / CLI and are server-side secrets. Timestamps are UTC ISO-8601 in both directions; inputs must carry an explicit `Z` or numeric offset. Every authenticated response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` headers. contact: name: SuperX url: https://superx.so servers: - url: https://api.superx.so security: - apiKey: [] tags: - name: Identity - name: Content - name: Analytics - name: Inspiration - name: Audience - name: Contact Lists - name: Signals - name: Media - name: Scheduling - name: Tags - name: Context - name: Queue - name: Articles - name: Meta paths: /v1/inspiration: get: tags: - Inspiration summary: Search the inspiration library description: | Search a library of 50M+ real high-performing posts by topic. Use the results for structures, hooks and angles to remix, never to copy. The library is user-level, so there is no `account_id` parameter. Results are intentionally varied: the same query returns a different mix on each call. Pagination is heuristic; `has_more` means a full page came back with library pages left (pages run 1 to 7). Each result carries an `outlier_score`: the post's engagement rate vs the expected rate for its author's follower tier, x10 (10 = expected, higher = overperformed). Null when the author's follower count is unknown. operationId: searchInspiration parameters: - name: q in: query required: true description: Topic or theme to search for (1-200 characters). schema: type: string minLength: 1 maxLength: 200 - name: sort in: query schema: type: string enum: - relevant - recent - likes - reposts - impressions - outlier default: relevant - name: min_likes in: query description: Only posts with at least this many likes. schema: type: integer minimum: 0 - name: min_reposts in: query description: Only posts with at least this many reposts. schema: type: integer minimum: 0 - name: min_replies in: query description: Only posts with at least this many replies. schema: type: integer minimum: 0 - name: min_bookmarks in: query description: Only posts with at least this many bookmarks. schema: type: integer minimum: 0 - name: min_impressions in: query description: Only posts with at least this many impressions. schema: type: integer minimum: 0 - name: min_length in: query description: Only posts with at least this many characters. schema: type: integer minimum: 0 - name: min_followers in: query description: Only posts from authors with at least this many followers. schema: type: integer minimum: 0 - name: max_followers in: query description: Only posts from authors with at most this many followers. schema: type: integer minimum: 0 - $ref: '#/components/parameters/Since' - $ref: '#/components/parameters/Until' - name: lang in: query description: Language code. schema: type: string default: en - name: exclude_topics in: query description: Comma-separated topics to exclude (keyword filter). schema: type: string example: crypto,politics - name: limit in: query description: Page size, 1 to 50. schema: type: integer minimum: 1 maximum: 50 default: 20 - name: page in: query description: 1-based page number, 1 to 7. schema: type: integer minimum: 1 maximum: 7 default: 1 responses: '200': description: A page of matching posts. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/InspirationPost' pagination: $ref: '#/components/schemas/Pagination' example: data: - id: '1938765432109876543' text: >- I built my first product in 30 days with zero audience. Here is exactly what I would do differently: posted_at: '2026-06-20T15:04:00.000Z' lang: en likes: 4211 replies: 312 reposts: 388 bookmarks: 1904 impressions: 512000 outlier_score: 14.2 author: handle: buildersam name: Sam Fields followers: 8421 verified: true pagination: page: 1 limit: 20 has_more: true '400': $ref: '#/components/responses/InvalidParameter' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/SubscriptionRequired' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/AccountsUnavailable' components: parameters: Since: name: since in: query required: false description: UTC ISO-8601 lower bound (explicit Z or offset required). schema: type: string format: date-time Until: name: until in: query required: false description: UTC ISO-8601 upper bound (explicit Z or offset required). schema: type: string format: date-time headers: X-RateLimit-Limit: description: The limit of the rate window closest to exhaustion. schema: type: integer X-RateLimit-Remaining: description: Requests remaining in that window. schema: type: integer X-RateLimit-Reset: description: Unix timestamp (seconds) when that window resets. schema: type: integer schemas: InspirationPost: type: object properties: id: type: string text: type: string posted_at: type: string format: date-time nullable: true lang: type: string nullable: true likes: type: integer replies: type: integer reposts: type: integer bookmarks: type: integer impressions: type: integer outlier_score: type: number nullable: true description: >- Engagement rate vs the expected rate for the author's follower tier, x10 (10 = expected, higher = overperformed). Null when the author's follower count is unknown. author: type: object properties: handle: type: string nullable: true name: type: string nullable: true followers: type: integer verified: type: boolean Pagination: type: object required: - page - limit - has_more properties: page: type: integer limit: type: integer has_more: type: boolean total: type: integer description: Present only where cheap to compute. ErrorEnvelope: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Stable machine-readable error code. message: type: string retry_after: type: integer description: Seconds to wait before retrying (rate-limit errors only). LegacyErrorEnvelope: type: object required: - error description: | Legacy shape used ONLY by the shared subscription middleware: a plain string `error` field. Seen on `403` when the subscription has lapsed (string starts with "subscription_required:") and on `500` when subscription verification fails (string starts with "internal_error:"). properties: error: type: string example: >- subscription_required: The SuperX API requires an active subscription responses: InvalidParameter: description: A parameter is missing, malformed, or out of range. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_parameter message: since must be a UTC ISO-8601 timestamp Unauthorized: description: >- Missing/malformed Authorization header (`unauthorized`) or an unknown/revoked key (`invalid_api_key`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_api_key message: Unknown or revoked API key SubscriptionRequired: description: | Subscription lapsed. NOTE the legacy body shape: `error` is a plain string here, not the `{ code, message }` object. Read-only keys on write endpoints instead get the object envelope with code `insufficient_scope`. content: application/json: schema: oneOf: - $ref: '#/components/schemas/LegacyErrorEnvelope' - $ref: '#/components/schemas/ErrorEnvelope' example: error: >- subscription_required: The SuperX API requires an active subscription RateLimited: description: Rate limit exceeded (limits vary by plan). Honor Retry-After. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: rate_limited message: >- Rate limit exceeded for the Pro plan (30 requests/min). Upgrade for higher limits. retry_after: 42 InternalError: description: >- Unexpected server error. May also use the legacy string envelope when subscription verification fails. content: application/json: schema: oneOf: - $ref: '#/components/schemas/ErrorEnvelope' - $ref: '#/components/schemas/LegacyErrorEnvelope' example: error: code: internal_error message: Failed to fetch posts AccountsUnavailable: description: >- Linked-account verification is temporarily unavailable (fail closed). The main account keeps working. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: accounts_unavailable message: >- Account information is temporarily unavailable. Try again shortly. securitySchemes: apiKey: type: http scheme: bearer description: >- A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets. ````