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

# Search Sella's Dataset Catalogue and API Data Market

> Search 1,400+ providers and a growing dataset catalogue using keyword filters, price caps, and schema requirements — all for free before you spend.

Discovery on Sella costs nothing. Before you evaluate a single dataset or call a single API, you can browse the entire catalogue — filtered by modality, format, price, and the exact column names your pipeline needs. Use discovery aggressively to cut the candidate list down to a handful of genuinely relevant results before you commit a cent.

## Search the dataset catalogue

`list_datasets` and `search_datasets` accept identical filter parameters. Both return titles, descriptions, modality, format, tier, price, and dataset IDs — never paid content. Use `list_datasets` to browse broadly and `search_datasets` when you have a specific query in mind.

<CodeGroup>
  ```json MCP tool call theme={null}
  {
    "name": "search_datasets",
    "arguments": {
      "query": "financial news sentiment",
      "modality": "structured",
      "format": "csv",
      "required_fields": ["headline", "sentiment"],
      "max_price_usdc": 25,
      "sort_by": "popular",
      "limit": 10
    }
  }
  ```

  ```bash REST equivalent theme={null}
  curl "https://sellag.vercel.app/api/datasets?search=sentiment&tier=premium&limit=10"
  ```
</CodeGroup>

The REST endpoint is read-only and requires no authentication — useful for quick catalogue browsing outside of an agent loop.

### Filter parameters

<ParamField path="query" type="string">
  Free-text search across title, description, and tags.
</ParamField>

<ParamField path="category" type="string">
  Restrict results to a single category.
</ParamField>

<ParamField path="tier" type="string">
  One of `free`, `standard`, `premium`, or `enterprise`.
</ParamField>

<ParamField path="modality" type="string">
  `structured` for tabular data or `document` for text and PDF content.
</ParamField>

<ParamField path="format" type="string">
  `csv`, `tsv`, `json`, `jsonl`, `parquet`, `txt`, `md`, or `pdf`.
</ParamField>

<ParamField path="required_fields" type="string[]">
  Return only datasets whose schema contains every column in this list. This is the single most effective filter — it eliminates datasets you would reject anyway after paying for a trial.
</ParamField>

<ParamField path="max_price_usdc" type="number">
  Cap the per-access price in USDC. Set to `0` to see only free datasets.
</ParamField>

<ParamField path="sort_by" type="string" default="newest">
  Sort order: `newest`, `popular`, `price_asc`, or `price_desc`.
</ParamField>

<ParamField path="limit" type="number" default="20">
  Number of results to return, between 1 and 100.
</ParamField>

<Tip>
  **Search free first.** Sella mirrors open datasets from Hugging Face and Kaggle alongside premium listings. Filter with `max_price_usdc: 0` — an open dataset often does the job and saves your budget for situations where quality genuinely demands a paid source.
</Tip>

## Search the API Data Market

`list_market_apis` searches 1,400+ aggregated third-party providers spanning image and video generation, web search and scraping, social data, crypto and finance feeds, email, inference, and more.

```json theme={null}
{
  "name": "list_market_apis",
  "arguments": {
    "query": "web scraping",
    "product_class": "B1",
    "chain": "base",
    "verified_only": true,
    "max_price_usdc": 0.01,
    "limit": 25
  }
}
```

<AccordionGroup>
  <Accordion title="Domain types (domain_type)" icon="tags">
    Codes `A1`–`A22` map to verticals — for example: `A1` image generation, `A3` video, `A7` web search, `A8` scraping, `A9` social data, `A10` email, `A14` crypto, `A16` finance, `A19` inference. Pass the relevant code to narrow results to a specific domain.
  </Accordion>

  <Accordion title="Product classes (product_class)" icon="boxes">
    `B1` pay-per-call API · `B2` data product · `B3` inference/playground · `B4` workflow · `B5` infra/dev-tool · `B6` physical commerce. Use `B1` for standard per-request APIs.
  </Accordion>

  <Accordion title="Other filters" icon="filter">
    `chain` (e.g. `base`, `solana`, `stellar`) restricts results to providers that settle on a specific network. `verified_only` hides unreviewed listings. `max_price_usdc` caps the per-call price. `limit` controls page size, defaulting to 25 with a maximum of 50.
  </Accordion>
</AccordionGroup>

<Note>
  Call `list_market_apis` at the start of each session rather than relying on cached results — provider availability and pricing change frequently. For full execution instructions, see [API Data Market](/consumers/api-market).
</Note>

## Discovery strategy

<CardGroup cols={2}>
  <Card title="Lead with required_fields" icon="crosshairs" href="/consumers/evaluate">
    Verifying schema up front eliminates irrelevant results before you spend any evaluation credits. Pair it with `max_price_usdc` to bound your budget in a single query.
  </Card>

  <Card title="Sort by popular" icon="trending-up" href="/consumers/evaluate">
    Purchase popularity is the fastest quality signal in the catalogue — what other agents repeatedly bought tends to be reliable. Start here before sorting by price.
  </Card>
</CardGroup>

Once you have a shortlist, move to [evaluate](/consumers/evaluate) to inspect schema coverage, sample rows, and quality datacards before you buy.