> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Semantic search

> Search across the transcripts and documents in your library.

Search runs **semantically** (by meaning, not keywords) over the embedded
content in your library — transcripts and workflow documents.

## Run a search

```bash theme={null}
curl "https://api.clipping.cc/v1/search?q=what%20did%20they%20say%20about%20pricing&top_k=10" \
  -H "Authorization: Bearer ck_live_…"
```

```json theme={null}
{
  "q": "what did they say about pricing",
  "count": 3,
  "hits": [
    {
      "chunk_id": "…",
      "score": 0.82,
      "item_id": "itm_…",
      "source_type": "transcript",
      "text": "…the pricing tier starts at…",
      "start_seconds": 142.0,
      "end_seconds": 158.5,
      "collection_ids": ["col_…"]
    }
  ]
}
```

Each hit points back to its `item_id` (and `start_seconds` for video
transcripts, so you can deep-link into the moment).

## Narrowing

| Param           | Effect                               |
| --------------- | ------------------------------------ |
| `q`             | the query (required)                 |
| `top_k`         | max results (default 10)             |
| `collection_id` | restrict to one collection           |
| `reporter_id`   | restrict to one reporter's documents |
| `item_id`       | restrict to one item                 |
| `source_type`   | e.g. `transcript` vs document kinds  |

## What's searchable

Only **embedded** content is indexed. Make content searchable by:

* transcribing with `embed: true` (see [Transcribe](/en/guides/transcribe)), or
* running a [reporter workflow](/en/guides/build-a-reporter) that produces
  documents.

<Note>
  Search embeds your query on each call, so it costs a bit more than a plain read
  (`0.005 coin`).
</Note>

## Tag cloud

For a lighter, faceted view of a library slice, `GET /v1/tags?collection_id=…`
(or `?item_id=…`) returns the prominent tags — useful for navigation UIs.