---
title: "Search Blobs"
method: GET
path: "/v1/blobs/search"
tags: ["blobs"]
---

# Search Blobs

`GET /v1/blobs/search`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/blobs/search`
- Auth: none declared

Find parsed blob chunks similar to ``q`` using the per-agent blob vector namespace.

## Query parameters

- `q` string, required: Natural-language query (embedded server-side).
- `limit` integer
- `threshold` number: Minimum cosine similarity score (0–1) for a hit.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- BlobSearchResponse: Semantic similarity search over parsed blob chunks (vector index).
  - `status` 'success'
  - `query` string, required
  - `hits` BlobSearchHit[], required
    - `blob_id` string, required
    - `parse_id` string, required
    - `chunk_index` integer, required
    - `score` number, required
    - `text` string, required
    - `content_type` string, nullable
  - `total_returned` integer, required
  - `usage` UsageInfo, required: Usage snapshot for the authenticated agent.
    - `calls_total` integer, required
    - `calls_remaining` integer, nullable
    - `over_limit` boolean
    - `upgrade_url` string
    - `search_quota_period` 'lifetime' | 'monthly' | 'trial_credits' | 'rolling_30d', nullable
    - `search_calls_limit` integer, nullable
    - `search_overage_rate_per_call` number, nullable
    - `credits_remaining_usd` string
  - `provider_used` 'vector'
  - `_lithtrix` LithtrixPropagationBlock, required: Passive discovery URLs included on high-traffic API responses.
    - `served_by` string, required
    - `register_url` string, required
    - `discover_url` string, required
    - `guide_url` string, required
    - `feedback_url` string, required
    - `terms_url` string, required
    - `terms_version` string, required
    - `browse_url` string, required
    - `search_id` string, nullable
    - `community` CommunityBlock: Founding-period community progress (D71) — sibling of ``usage`` under ``_lithtrix``.
      - `agents_total` integer, required
      - `agents_active_30d` integer, required
      - `agents_target` integer
      - `percent_to_target` number, required
      - `founding_period` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lithtrix/apis/lithtrix-api.md) · [All operations](https://skmtc.dev/lithtrix/apis/lithtrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lithtrix/apis/lithtrix-api/revisions/be5de51bf4f8?raw)