---
title: "Search merchants"
method: GET
path: "/api/merchants/search"
tags: ["Merchants"]
---

# Search merchants

`GET /api/merchants/search`

Search Merchants by name

## Query parameters

- `name` string, required
- `only_priority` boolean

## Response `200`

A list of up to 5 merchants which match the search term, sorted by descending order of their URL rank and the frequency this merchant has been seen historically.

- object
  - `merchants` Merchant[]
    - `categories` MerchantCategory[]
      - `code` string, required
      - `description` string, nullable
      - `slug` string, nullable
    - `group_id` 'Uber' | 'Google' | 'Intuit' | 'debt.mca_or_rbf' | 'debt.non_bank_business' | 'debt.equipment_and_auto_leasing' | 'debt.mortgage' | 'debt.personal_non_mortgage' | 'debt.collections' | 'debt.bank' | 'invoice_factoring' | 'fuel_provider' | 'gambling_and_betting' | 'null', nullable
    - `heron_id` string
    - `icon_url` string, url, nullable
    - `is_priority` boolean
    - `logo_url` string, url, nullable
    - `name` string, required
    - `url` string, url, required

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/herondata/heron-data-api/revisions/f2e441edece2/schema)