---
layout: default
title: Nostr Content Search
description: Job to search for notes based on a prompt
---

# Input
Text to be included in the search

# Output

A `content` JSON-stringified list of tags. Tags SHOULD be `a` or `e`.

# Params

* `users`: A list of pubkeys of a users to filter notes from (Optional parameter)
* `since`: unix timestamp in seconds to start the search (Optional parameter)
* `until`: unix timestamp in seconds to end the search (Optional parameter)
* `max_results`: Maximum number of events to return (Optional parameter)

# How clients can use this

Clients can ask a Search DVM to return notes based on certain filters. 


# Example

#### Request

```json
{
    "content": "",
    "kind": 5302,
    "tags":
     [
        [ "i", "shipyard", "text" ],
        ["param","max_results","100"],
        ["param","users","[[\"p\", \"6e468422dfb74a5738702a8823b9b28168abab8655faacb6853cd0ee15deee93\"]]"]
     ]
}
```

#### Response

```json
{
    "kind": 6302,
    "content": "[ \"e\", \"<...>\" ],[ \"e\", \"<...>\" ],[ \"e\", \"<...>\" ],[ \"e\", \"<...>\" ]"
}
```