zzstoatzz.io
search for standard sites
pub-search.waow.tech
search
zig
blog
atproto
docs: add author filter to API docs and search syntax guide
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+1
-1
README.md
+1
-1
README.md
···
28
28
## api
29
29
30
30
```
31
-
GET /search?q=<query>&mode=keyword|semantic|hybrid&platform=<platform>&tag=<tag>&since=<date>&format=v2
31
+
GET /search?q=<query>&mode=keyword|semantic|hybrid&platform=<platform>&tag=<tag>&since=<date>&author=<did|handle>&format=v2
32
32
GET /similar?uri=<at-uri>&format=v2
33
33
GET /tags
34
34
GET /popular
+6
-5
docs/api.md
+6
-5
docs/api.md
···
7
7
### search
8
8
9
9
```
10
-
GET /search?q=<query>&tag=<tag>&platform=<platform>&since=<date>&mode=<mode>
10
+
GET /search?q=<query>&tag=<tag>&platform=<platform>&since=<date>&author=<did|handle>&mode=<mode>
11
11
```
12
12
13
13
full-text search across documents and publications.
···
19
19
| `tag` | string | no | filter by tag (documents only) |
20
20
| `platform` | string | no | filter by platform: `leaflet`, `pckt`, `offprint`, `greengale`, `whitewind`, `other` |
21
21
| `since` | string | no | ISO date, filter to documents created after |
22
+
| `author` | string | no | filter by author: DID (`did:plc:xyz`) or handle (`nate.bsky.social`). handles are resolved server-side via AT Protocol. |
22
23
| `mode` | string | no | `keyword` (default), `semantic`, or `hybrid`. semantic uses voyage-4-lite embeddings + turbopuffer ANN. hybrid merges keyword + semantic via reciprocal rank fusion. |
23
24
| `format` | string | no | `v2` wraps response in `{"results": [...], "total": N, "hasMore": bool}` |
24
25
| `limit` | int | no | max results to return (default 20) |
25
26
| `offset` | int | no | pagination offset |
26
27
27
-
*at least one of `q` or `tag` required
28
+
*at least one of `q`, `tag`, or `author` required
28
29
29
30
**filter behavior by mode:**
30
-
- **keyword**: respects all filters (`tag`, `platform`, `since`)
31
-
- **semantic**: respects `platform` only. ignores `tag` and `since`.
32
-
- **hybrid**: keyword half respects all filters, semantic half respects `platform` only. results merged via RRF.
31
+
- **keyword**: respects all filters (`tag`, `platform`, `since`, `author`)
32
+
- **semantic**: respects `platform` and `author`. ignores `tag` and `since`.
33
+
- **hybrid**: keyword half respects all filters, semantic half respects `platform` and `author`. results merged via RRF.
33
34
34
35
**response:**
35
36
```json
+2
-1
docs/search-syntax.md
+2
-1
docs/search-syntax.md
···
29
29
30
30
beyond the query text, you can filter results by:
31
31
32
+
- **author**: type `@handle` in the search box (e.g., `@zat.dev up`). quote to search literally: `"@zat.dev"`.
32
33
- **platform**: leaflet, pckt, offprint, greengale, whitewind, other
33
34
- **tag**: click any tag in the results to filter by it
34
35
- **date**: today, this week, this month, this year
35
36
36
-
filters combine with the search query — e.g., searching `python` with the `leaflet` platform filter returns only leaflet posts matching "python".
37
+
filters combine with the search query — e.g., searching `@zat.dev up` returns only zat.dev's posts matching "up".
37
38
38
39
## search modes
39
40
+1
-1
mcp/README.md
+1
-1
mcp/README.md
···
28
28
29
29
| tool | description |
30
30
|------|-------------|
31
-
| `search` | search documents by query, tag, platform, or date |
31
+
| `search` | search documents by query, tag, platform, date, or author |
32
32
| `get_document` | retrieve full content by AT-URI |
33
33
| `find_similar` | find semantically similar documents |
34
34
| `get_tags` | list all tags with document counts |