> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnixapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Bookmarks > Search the authed user's bookmarks by text/author. Page with `next_cursor` to scan further. ## OpenAPI ````yaml /api-reference/openapi.json post /user/bookmark_search openapi: 3.1.0 info: title: OmniX API version: 1.0.0 description: >- The fastest X (Twitter) API. Read and write tweets, users, lists, media and articles with a single API key. Every request runs as a real X account you supply via `auth_token`. Flat $0.001 per successful call. servers: - url: https://api.omnixapi.com/api/v1/twitter security: - bearerAuth: [] tags: - name: Tweets description: Search, read and write tweets. - name: Users description: Profiles, timelines, networks and profile actions. - name: Lists description: X List data. - name: Media description: Upload images, GIFs and video. - name: Articles description: Long-form X Articles. - name: Direct Messages description: >- Read and send X (XChat) direct messages. Encrypted operations require your `encryption_code` (XChat PIN). - name: Webhooks description: >- Real-time event delivery. Register an https URL and OmniX POSTs typed, signed events for DMs, mentions, replies, likes and follows. - name: Account description: >- Your OmniX account details, credit balance, usage and payment history. Free — no credits deducted, and no X account token required. paths: /user/bookmark_search: post: tags: - Users summary: Search Bookmarks description: >- Search the authed user's bookmarks by text/author. Page with `next_cursor` to scan further. operationId: bookmarkSearch requestBody: required: true content: application/json: schema: type: object required: - auth_token - q properties: auth_token: $ref: '#/components/schemas/AuthTokenField' q: type: string description: Match against bookmark text/author. example: ethereum count: type: integer default: 20 cursor: type: string proxy: $ref: '#/components/schemas/ProxyField' responses: '200': description: Matching bookmarks. content: application/json: schema: allOf: - $ref: '#/components/schemas/Envelope' - type: object properties: data: type: object properties: userId: type: string query: type: string tweet_count: type: integer has_more: type: boolean next_cursor: type: string nullable: true bookmarks: type: array items: $ref: '#/components/schemas/Tweet' components: schemas: AuthTokenField: type: string description: The X account `auth_token` cookie the action runs as. example: YOUR_X_AUTH_TOKEN ProxyField: type: string description: >- Optional outbound proxy for this call (`http://` or `https://`, optionally `user:pass@host:port`). The X request runs through it — useful for geo-routing or spreading calls across IPs. SOCKS proxies are not supported. example: http://user:pass@host:8080 Envelope: type: object properties: status: type: boolean example: true data: type: object error: type: string nullable: true example: null Tweet: type: object properties: type: type: string example: tweet id: type: string example: '1899999999999999999' url: type: string nullable: true twitterUrl: type: string nullable: true text: type: string example: Exciting times ahead source: type: string nullable: true example: Twitter for iPhone retweetCount: type: integer example: 1200 replyCount: type: integer example: 3400 likeCount: type: integer example: 56000 quoteCount: type: integer example: 210 viewCount: type: integer nullable: true example: 4500000 bookmarkCount: type: integer example: 800 createdAt: type: string example: Wed Jun 11 18:30:00 +0000 2025 lang: type: string example: en isReply: type: boolean inReplyToId: type: string nullable: true inReplyToUserId: type: string nullable: true conversationId: type: string nullable: true media: type: array items: $ref: '#/components/schemas/Media' entities: $ref: '#/components/schemas/Entities' author: $ref: '#/components/schemas/Author' quoted_tweet: type: object nullable: true Media: type: object properties: type: type: string example: photo url: type: string expanded_url: type: string nullable: true video_url: type: string nullable: true width: type: integer nullable: true height: type: integer nullable: true duration_ms: type: integer nullable: true Entities: type: object properties: hashtags: type: array items: type: object symbols: type: array items: type: object timestamps: type: array items: type: object urls: type: array items: type: object user_mentions: type: array items: type: object Author: type: object properties: type: type: string example: user id: type: string example: '44196397' userName: type: string example: elonmusk name: type: string example: Elon Musk url: type: string nullable: true twitterUrl: type: string nullable: true isVerified: type: boolean isBlueVerified: type: boolean verifiedType: type: string nullable: true profilePicture: type: string nullable: true coverPicture: type: string nullable: true description: type: string location: type: string nullable: true followers: type: integer following: type: integer favouritesCount: type: integer statusesCount: type: integer mediaCount: type: integer canDm: type: boolean createdAt: type: string nullable: true pinnedTweetIds: type: array items: type: string securitySchemes: bearerAuth: type: http scheme: bearer description: Your OmniX API key, e.g. `omnix_live_...`. Billed per call. ````