---
id: upstash/skills/upstash-search-js
version: "69e0af3c"
license: MIT
install: manual
updated: 2026-07-14
---

# upstash-search-js — This skill covers Upstash Search fundamentals for TypeScript and JavaScript developers. It walks through SDK installation, creating indexes, upserting documents, and executing searches with optional filtering and reranking. Use it to understand core concepts like content versus metadata and to implement end-to-end search workflows.

Publisher: upstash · Stars: 15 · Updated: 2026-07-14

Install (manual): `git clone https://github.com/upstash/skills`

## SKILL.md

# 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


[View on SkillFed](https://skillfed.io/upstash/skills/upstash-search-js) · [View on GitHub](https://github.com/upstash/skills)