Skip to content

upstash-search-js

Work with the @upstash/search TypeScript/JavaScript SDK, a serverless full-text and semantic search database with built-in reranking. Use when adding search to an app or site, creating a search index, upserting documents with searchable content and filterable metadata, running keyword, semantic, or hybrid search queries, reranking results, filtering with SQL-like or structured filter syntax, paginating with range, fetching or deleting documents, resetting an index, or checking index info. Also use when the user asks for site search, product, document, or knowledge-base search, or a managed search service that needs no cluster to run.

1,232
installs
0 up / 0 down, score 0.00
votes
33
repo stars
Updated
less than a month ago
In the catalog since
6 Oct 2026
From
upstash/skills
Get it through your agent npx skills add upstash/skills@upstash-search-js

Skill instructions

Rendered from the published SKILL.md, 49 lines.

Upstash Search Documentation

Quick Start

Install the TS SDK:

npm install @upstash/search

Create a client and perform a simple upsert + search:

import { Search } from "@upstash/search";

const client = new Search({ url: process.env.UPSTASH_SEARCH_REST_URL, token: process.env.UPSTASH_SEARCH_REST_TOKEN });
const index = client.index("my-index");

await index.upsert({ id: "1", content: { text: "hello world" } });
const results = await index.search({ query: "hello" });

Basic steps:

  • Create an index
  • Insert or update documents
  • Run searches or filtered queries

Other Skill Files

sdk-overview

Provides detailed documentation for all TypeScript SDK commands. Includes:

  • delete: Deleting documents
  • fetch: Retrieving a document
  • info: Index info
  • range: Range queries
  • reset: Clearing an index
  • search: Search queries
  • upsert: Adding/updating documents
  • getting-started: Setup steps for the SDK

quick-start

Provides a fast, end-to-end workflow for creating a Search database, adding documents, and querying them. Covers essential concepts including:

  • Creating a database and storing credentials
  • Adding documents with content and metadata
  • Understanding content vs metadata (searchability and filterability)
  • Performing searches with optional reranking
  • Filtering syntax with SQL-like or structured filters
  • Common pitfalls and best practices