# you_search

tool by [@c0va23](/marketplace/@c0va23/tools)

A tool that fetches ydc-index.io.

- First published 2026-10-27 · release 2 on 2026-10-28
- [Download release 2](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8/latest.bylm.json)
- [0 stars](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8/stars)
- Needs a key: **You.com** — sent to https://ydc-index.io. Hint: Dashboard: sign in at you.com/platform, create an API key, and paste it here. [Get a key](https://you.com/platform/api-keys)

## What it holds

### What the model is told

**Tool the model sees**: `fetch_url-you_search`

```text
Search the live web with the You.com Web Search API (POST https://ydc-index.io/v1/search). Returns ranked web results, news articles and licensed knowledge facts, each with query-relevant highlight excerpts. Use for any question needing current or factual information from the web.
```

### Request

**Method and address**: `POST https://ydc-index.io/v1/search`

**Headers sent**:

- `X-API-Key: {secrets.apiKey}`

**Body**: `application/json`

```json
{
  "query": "{query}",
  "count": {count},
  "extraction": {
    "extraction_mode": "highlights",
    "highlights": {
      "total_max_tokens": 2048
    }
  }
}
```

**Accepted responses**: `application/json`

### Arguments the model passes

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | yes |  | The search query. Search operators such as quoted phrases, site: and -term are supported. |
| `count` | integer | no | `6` | How many results to return per section (web and news). 1-50; 6 is a good balance. |

### Responses

**Statuses that are errors**: 400 to 599

**A response filtered to nothing is an error**: no

**What the model reads for an error**: The status line, then the body

**Retries**: A 429 or a 503 is sent again, 3 times at most, waiting 1000 ms first and doubling, 60000 ms at most

**Kept for the app's response details screen**: the first 65536 characters of the body and of each filter's output; the model never reads them

**Cost, in US dollars, read by a jq program**:

```
select($status == 200) | 0.005
```

An expression that fails records nothing and keeps the response.

### Filters over the response, in order

#### Step 1

A jq program, giving `text/markdown`

```
def clip: if (length > 700) then .[0:700] + " …" else . end;
def ex: ([((( .contents.highlights // .snippets) // []) | .[0:6])[] | "- " + clip] | join("\n"));
(.results // {}) as $r |
[
  ("Query: " + ((.metadata.query) // "")),
  ( ($r.web // [])[] | "### " + (.title // "(untitled)") + "\nURL: " + (.url // "") + (if .page_age then "\nAge: " + .page_age else "" end) + (if .description then "\n" + .description else "" end) + "\n" + ex ),
  ( ($r.news // [])[] | "### [news] " + (.title // "(untitled)") + "\nURL: " + (.url // "") + (if .page_age then "\nPublished: " + .page_age else "" end) + (if .description then "\n" + .description else "" end) + "\n" + ex ),
  ( ($r.knowledge // [])[] | "### [licensed data] " + (.title // "") + (if .as_of then "\nAs of: " + .as_of else "" end) + (if .description then "\n" + .description else "" end) + "\nSource: " + ([.attribution[]?.name] | join(", ")) )
] | if length <= 1 then "No results were returned for this query." else join("\n\n") end
```

When the program outputs several values, only the first is passed on. A string is passed on without its quotes.

### Keys

**`apiKey`**: **You.com**, an API key

## Downloads

Downloaded 7 times directly. Included in 3 downloads of other listings. 7 downloads in the last 30 days.

## Releases

| Release | Published | Downloads | File |
| --- | --- | --- | --- |
| [2](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8/releases/2) | 2026-10-28 | [4](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8?release=2) | [download](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8/v/2.bylm.json) |
| [1](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8/releases/1) | 2026-10-27 | [3](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8?release=1) | [download](/marketplace/listings/01a17b91-c23c-7096-9fbe-74337683a6f8/v/1.bylm.json) |

---

[Bring Your LM](/) · [Docs](/docs/features) · [Marketplace](/marketplace)

[Articles](/articles) · [Releases](/releases) · [Bundle Format](/marketplace/bundle-format) · [Marketplace Terms](/terms) · [App Privacy](/privacy) · [Website Privacy](/website-privacy) · [Open Source](/open-source) · [llms.txt](/llms.txt)