---
title: "Businesses in the indexes by name or domain, filtered by city, kind, grade, builder, vendor and finding; 50 a page, best scores first"
method: GET
path: "/api/search"
---

# Businesses in the indexes by name or domain, filtered by city, kind, grade, builder, vendor and finding; 50 a page, best scores first

`GET /api/search`

## Request

- Base URL: `https://directindex.org`
- URL: `https://directindex.org/api/search`
- Auth: one of:
  - none
  - HTTP bearer

## Query parameters

- `q` string
- `city` string
- `kind` 'restaurants' | 'cafes' | 'salons' | 'clinics' | 'tours'
- `grade` 'A' | 'B' | 'C' | 'D' | 'F'
- `builder` string
- `vendor` string
- `finding` string
- `page` integer

## Response `200`

Search results

---

[API](https://skmtc.dev/directindex/apis/the-direct-index-api.md) · [All operations](https://skmtc.dev/directindex/apis/the-direct-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/directindex/apis/the-direct-index-api/revisions/c3390f276403?raw)