Search inside a saved view

curl --request POST \
  --url https://memex.garden/api/execute-view-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "viewId": "view_123",
  "query": "vector database benchmarks",
  "limit": 10,
  "enableRerank": true
}
'

{
  "results": [
    {
      "id": "<string>",
      "type": "web",
      "created_at": 123,
      "updated_at": 123,
      "url": "<string>",
      "title": "<string>",
      "normalized_url": "<string>",
      "user_id": "<string>",
      "external_id": "<string>",
      "tag_ids": [
        "<string>"
      ],
      "reference_content_ids": [
        "<string>"
      ],
      "canonical_url": "<string>",
      "favicon_url": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "author": "<string>",
      "date": "<string>",
      "html": "<string>",
      "full_text": "<string>",
      "annotations": [
        {
          "id": "<string>",
          "type": "web",
          "created_at": 123,
          "updated_at": 123,
          "url": "<string>",
          "title": "<string>",
          "normalized_url": "<string>",
          "resolvedReferences": [
            {
              "id": "<string>",
              "type": "web",
              "created_at": 123,
              "updated_at": 123,
              "url": "<string>",
              "title": "<string>",
              "normalized_url": "<string>",
              "user_id": "<string>",
              "external_id": "<string>",
              "tag_ids": [
                "<string>"
              ],
              "reference_content_ids": [
                "<string>"
              ],
              "canonical_url": "<string>",
              "favicon_url": "<string>",
              "description": "<string>",
              "keywords": "<string>",
              "author": "<string>",
              "date": "<string>",
              "html": "<string>",
              "full_text": "<string>"
            }
          ],
          "user_id": "<string>",
          "external_id": "<string>",
          "tag_ids": [
            "<string>"
          ],
          "reference_content_ids": [
            "<string>"
          ],
          "canonical_url": "<string>",
          "favicon_url": "<string>",
          "description": "<string>",
          "keywords": "<string>",
          "author": "<string>",
          "date": "<string>",
          "html": "<string>",
          "full_text": "<string>",
          "text": "<string>"
        }
      ]
    }
  ],
  "extraEntities": [
    {
      "id": "<string>",
      "type": "web",
      "created_at": 123,
      "updated_at": 123,
      "url": "<string>",
      "title": "<string>",
      "normalized_url": "<string>",
      "user_id": "<string>",
      "external_id": "<string>",
      "tag_ids": [
        "<string>"
      ],
      "reference_content_ids": [
        "<string>"
      ],
      "canonical_url": "<string>",
      "favicon_url": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "author": "<string>",
      "date": "<string>",
      "html": "<string>",
      "full_text": "<string>"
    }
  ],
  "referencesByResultId": {},
  "referencedEntities": [
    {
      "id": "<string>",
      "type": "web",
      "created_at": 123,
      "updated_at": 123,
      "url": "<string>",
      "title": "<string>",
      "normalized_url": "<string>",
      "user_id": "<string>",
      "external_id": "<string>",
      "tag_ids": [
        "<string>"
      ],
      "reference_content_ids": [
        "<string>"
      ],
      "canonical_url": "<string>",
      "favicon_url": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "author": "<string>",
      "date": "<string>",
      "html": "<string>",
      "full_text": "<string>"
    }
  ],
  "referencedTags": [
    {
      "id": "<string>",
      "name": "<string>",
      "created_at": 123,
      "updated_at": 123
    }
  ],
  "meta": {
    "offset": 123,
    "limit": 123,
    "returnedCount": 123,
    "rerankApplied": true,
    "usageMicrosCharged": 123,
    "remainingUsageBalance": {
      "usageBalancePaygMicros": 123,
      "usageBalanceSubscriptionMicros": 123,
      "total": 123
    }
  },
  "error": "<string>"
}

{
  "error": "Unauthorized"
}

{
  "error": "Internal server error",
  "message": "<string>"
}

POST

execute-view-search

curl --request POST \
  --url https://memex.garden/api/execute-view-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "viewId": "view_123",
  "query": "vector database benchmarks",
  "limit": 10,
  "enableRerank": true
}
'

{
  "results": [
    {
      "id": "<string>",
      "type": "web",
      "created_at": 123,
      "updated_at": 123,
      "url": "<string>",
      "title": "<string>",
      "normalized_url": "<string>",
      "user_id": "<string>",
      "external_id": "<string>",
      "tag_ids": [
        "<string>"
      ],
      "reference_content_ids": [
        "<string>"
      ],
      "canonical_url": "<string>",
      "favicon_url": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "author": "<string>",
      "date": "<string>",
      "html": "<string>",
      "full_text": "<string>",
      "annotations": [
        {
          "id": "<string>",
          "type": "web",
          "created_at": 123,
          "updated_at": 123,
          "url": "<string>",
          "title": "<string>",
          "normalized_url": "<string>",
          "resolvedReferences": [
            {
              "id": "<string>",
              "type": "web",
              "created_at": 123,
              "updated_at": 123,
              "url": "<string>",
              "title": "<string>",
              "normalized_url": "<string>",
              "user_id": "<string>",
              "external_id": "<string>",
              "tag_ids": [
                "<string>"
              ],
              "reference_content_ids": [
                "<string>"
              ],
              "canonical_url": "<string>",
              "favicon_url": "<string>",
              "description": "<string>",
              "keywords": "<string>",
              "author": "<string>",
              "date": "<string>",
              "html": "<string>",
              "full_text": "<string>"
            }
          ],
          "user_id": "<string>",
          "external_id": "<string>",
          "tag_ids": [
            "<string>"
          ],
          "reference_content_ids": [
            "<string>"
          ],
          "canonical_url": "<string>",
          "favicon_url": "<string>",
          "description": "<string>",
          "keywords": "<string>",
          "author": "<string>",
          "date": "<string>",
          "html": "<string>",
          "full_text": "<string>",
          "text": "<string>"
        }
      ]
    }
  ],
  "extraEntities": [
    {
      "id": "<string>",
      "type": "web",
      "created_at": 123,
      "updated_at": 123,
      "url": "<string>",
      "title": "<string>",
      "normalized_url": "<string>",
      "user_id": "<string>",
      "external_id": "<string>",
      "tag_ids": [
        "<string>"
      ],
      "reference_content_ids": [
        "<string>"
      ],
      "canonical_url": "<string>",
      "favicon_url": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "author": "<string>",
      "date": "<string>",
      "html": "<string>",
      "full_text": "<string>"
    }
  ],
  "referencesByResultId": {},
  "referencedEntities": [
    {
      "id": "<string>",
      "type": "web",
      "created_at": 123,
      "updated_at": 123,
      "url": "<string>",
      "title": "<string>",
      "normalized_url": "<string>",
      "user_id": "<string>",
      "external_id": "<string>",
      "tag_ids": [
        "<string>"
      ],
      "reference_content_ids": [
        "<string>"
      ],
      "canonical_url": "<string>",
      "favicon_url": "<string>",
      "description": "<string>",
      "keywords": "<string>",
      "author": "<string>",
      "date": "<string>",
      "html": "<string>",
      "full_text": "<string>"
    }
  ],
  "referencedTags": [
    {
      "id": "<string>",
      "name": "<string>",
      "created_at": 123,
      "updated_at": 123
    }
  ],
  "meta": {
    "offset": 123,
    "limit": 123,
    "returnedCount": 123,
    "rerankApplied": true,
    "usageMicrosCharged": 123,
    "remainingUsageBalance": {
      "usageBalancePaygMicros": 123,
      "usageBalanceSubscriptionMicros": 123,
      "total": 123
    }
  },
  "error": "<string>"
}

{
  "error": "Unauthorized"
}

{
  "error": "Internal server error",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Option 1
Option 2

viewId

string

required

Saved view ID accessible to the authenticated user.

token

string

Public token for a shared view. Can be used without bearer auth when the view is public.

query

string

rewriteQuery

boolean

forceFullQueryProcessing

boolean

enableRerank

boolean

rerankWindow

integer

Required range: 1 <= x <= 100

includeChunkContext

boolean

tagIds

string[]

Optional tag IDs to further filter the view. IDs must already belong to the view scope.

contentTypes

enum<string>[]

Exact persisted content_entity.type value.

Available options:

web,

pdf,

youtube,

twitter,

instagram,

tiktok,

facebook,

linkedin,

pinterest,

reddit,

chatgpt,

claude,

annotation,

image,

transcribedMedia,

audioRecording,

selector,

chatThread,

twitterProfile,

subreddit,

youtubeChannel

timeRange

object

Show child attributes

sortBy

enum<string>

Available options:

date-desc,

date-asc

offset

integer

default:0

Required range: x >= 0

limit

integer

default:30

Required range: 1 <= x <= 500

Response

Raw scoped search response

Full machine-readable search response returned when raw is true. Includes search graph fields for programmatic processing.

results

object[]

required

Search results. When includeNotes is true, each result includes an annotations array.

Union over Memex content entities. API-facing documented variants are web, twitter (tweets), youtube, image, and reddit.

Show child attributes

extraEntities

object[]

required

Union over Memex content entities. API-facing documented variants are web, twitter (tweets), youtube, image, and reddit.

Show child attributes

referencesByResultId

object

required

Map of result content ID to referenced content/tag IDs.

Show child attributes

referencedEntities

object[]

required

Union over Memex content entities. API-facing documented variants are web, twitter (tweets), youtube, image, and reddit.

Show child attributes

referencedTags

object[]

required

Show child attributes

General

API reference

Plugins

Search inside a saved view

Authorizations

Body

Response