> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myme.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Search items

> Full-text search across the tenant's items. Indexes textual properties (body, title, description, name, and other string-typed fields not flagged `searchable: false`) plus tags. Ranking is by relevance with a configurable recency boost.

Accepts the same filter parameters as `GET /items` — narrow by `type`, `state`, `tier`, `tags`, source, edge / backref clauses — so the search query and the filter set compose. `tags` is comma-separated with AND semantics.

Uses `limit` / `offset` pagination rather than cursors. Result ordering is stable for the query's lifetime; absolute `score` values are not guaranteed across index rebuilds. See [Search and query](/api/search-and-query).



## OpenAPI

````yaml /openapi.json get /search
openapi: 3.1.0
info:
  title: Marfa API
  version: 4.2.0
  description: Typed data layer for structured personal data
servers: []
security: []
paths:
  /search:
    get:
      tags:
        - Search
      summary: Search items
      description: >-
        Full-text search across the tenant's items. Indexes textual properties
        (body, title, description, name, and other string-typed fields not
        flagged `searchable: false`) plus tags. Ranking is by relevance with a
        configurable recency boost.


        Accepts the same filter parameters as `GET /items` — narrow by `type`,
        `state`, `tier`, `tags`, source, edge / backref clauses — so the search
        query and the filter set compose. `tags` is comma-separated with AND
        semantics.


        Uses `limit` / `offset` pagination rather than cursors. Result ordering
        is stable for the query's lifetime; absolute `score` values are not
        guaranteed across index rebuilds. See [Search and
        query](/api/search-and-query).
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: q
          in: query
        - schema:
            type: string
          required: false
          name: type
          in: query
        - schema:
            type: string
            enum:
              - active
              - archived
              - trashed
              - revoked
          required: false
          name: state
          in: query
        - schema:
            type: string
            enum:
              - library
              - feed
              - all
          required: false
          name: tier
          in: query
        - schema:
            type: string
          required: false
          name: include
          in: query
        - schema:
            type: string
          required: false
          name: tags
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          required: false
          name: limit
          in: query
        - schema:
            type: integer
            nullable: true
            minimum: 0
            maximum: 10000
            default: 0
          required: false
          name: offset
          in: query
        - schema:
            type: string
          required: false
          name: filter
          in: query
      responses:
        '200':
          description: Search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        item:
                          type: object
                          properties:
                            id:
                              type: string
                            type:
                              type: string
                            properties:
                              type: object
                              additionalProperties:
                                nullable: true
                            state:
                              type: string
                              enum:
                                - active
                                - archived
                                - trashed
                                - revoked
                            tier:
                              type: string
                              enum:
                                - library
                                - feed
                            tenant_id:
                              type: string
                              nullable: true
                            version:
                              type: number
                            schema_version:
                              type: integer
                            source:
                              type: string
                            source_id:
                              type: string
                            device:
                              type: string
                            capture_latitude:
                              type: number
                            capture_longitude:
                              type: number
                            timestamp:
                              type: string
                            created_at:
                              type: string
                            updated_at:
                              type: string
                            edges:
                              type: object
                              additionalProperties:
                                type: object
                                properties:
                                  edges:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                        tenant_id:
                                          type: string
                                          nullable: true
                                        source_id:
                                          type: string
                                        target_id:
                                          type: string
                                        edge_type:
                                          type: string
                                        properties:
                                          type: object
                                          additionalProperties:
                                            nullable: true
                                        created_at:
                                          type: string
                                        updated_at:
                                          type: string
                                      required:
                                        - id
                                        - source_id
                                        - target_id
                                        - edge_type
                                        - properties
                                        - created_at
                                        - updated_at
                                  has_more:
                                    type: boolean
                                  next_cursor:
                                    type: string
                                required:
                                  - edges
                                  - has_more
                            extensions:
                              type: object
                              additionalProperties:
                                type: object
                                additionalProperties:
                                  nullable: true
                          required:
                            - id
                            - type
                            - properties
                            - state
                            - version
                            - schema_version
                            - source
                            - timestamp
                            - created_at
                            - updated_at
                          additionalProperties:
                            nullable: true
                        metadata:
                          type: object
                          properties:
                            item_id:
                              type: string
                            tags:
                              type: array
                              items:
                                type: string
                            extensions:
                              type: object
                              additionalProperties:
                                nullable: true
                          required:
                            - item_id
                            - tags
                            - extensions
                          additionalProperties:
                            nullable: true
                        relevance_score:
                          type: number
                        snippet_html:
                          type: string
                        snippet:
                          type: string
                      required:
                        - item
                        - metadata
                        - relevance_score
                required:
                  - results
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - unauthorized
                      message:
                        type: string
                      details:
                        type: object
                        additionalProperties:
                          nullable: true
                    required:
                      - code
                      - message
                required:
                  - error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key or OAuth Token
      description: Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)

````