---
title: "Bounded recorded URL batches for indexing/submission workflows."
method: GET
path: "/api/indexing/urls"
tags: ["Agent Docs"]
---

# Bounded recorded URL batches for indexing/submission workflows.

`GET /api/indexing/urls`

## Request

- Base URL: `https://huggingbay.xyz`
- URL: `https://huggingbay.xyz/api/indexing/urls`
- Auth: none declared

Bounded recorded URL batches for indexing/submission workflows.

**Inputs.** Path, query and header fields are listed below. No request body is required.

**Outputs.** See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

**Errors.** API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

**Rate limits.** Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

## Query parameters

- `kind` 'static' | 'publisher' | 'ranking' | 'stack' | 'intent' | 'answer' | 'citation-pack' | 'source' | 'topic' | 'artifact' | 'artifact-section' | 'artifact-evidence' | 'downloadable' | 'agent-doc'
- `projection` 'rich' | 'url-only'
- `limit` integer
- `cursor` string
- `q` string
- `source` string
- `type` string
- `license` string
- `format` string
- `hosting` string
- `reviewStatus` 'first-review' | 'needs-evidence' | 'reviewed' | 'benchmark'
- `tool` 'ollama' | 'lm-studio' | 'comfyui' | 'transformers' | 'llama.cpp'
- `commercial` boolean
- `verified` boolean
- `sort` 'best' | 'ready' | 'mirrorable' | 'trust' | 'downloads' | 'stars' | 'mirrors' | 'demand' | 'name' | 'size' | 'license' | 'updated'

## Response `200`

URL batch

- union
  - IndexingUrlBatch
    - `schemaVersion` 'hugging-bay.indexing-url-batch.v1', required
    - `generatedAt` string, required
    - `kind` string, required
    - `rows` IndexingUrl[], required (unresolved $ref)
    - `filters` object
    - `total` number, required
    - `limit` number, required
    - `cursor` string, required
    - `nextCursor` string, nullable, required
  - IndexingUrlOnlyBatch
    - `schemaVersion` 'hugging-bay.indexing-url-batch.url-only.v1', required
    - `projection` 'url-only', required
    - `kind` string, required
    - `rows` object[], required
      - `url` string, uri, required
    - `filters` object
    - `total` number, required
    - `limit` number, required
    - `cursor` string, required
    - `nextCursor` string, nullable, required
    - `estimatedTotal` boolean

## Other responses

- `400`: Unsupported indexing kind
- `413`: A single compact URL row exceeds the 256 KiB response ceiling
- `503`: recorded public read authority is temporarily unavailable; retry after the indicated delay.

---

[API](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api.md) · [All operations](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/huggingbay/apis/hugging-bay-public-api/revisions/63c474bf0fe4?raw)