GET
/
api
/
merchants
/
search
curl --request GET \
  --url https://app.herondata.io/api/merchants/search \
  --header 'Authorization: Basic <encoded-value>'
{
  "merchants": [
    {
      "categories": [
        {
          "code": "7311",
          "description": "Advertising services",
          "slug": "advertising_services"
        }
      ],
      "group_id": "Uber",
      "heron_id": "mrc_H4woHtq2y7hw3GLRh4hv62",
      "icon_url": "<string>",
      "is_priority": true,
      "logo_url": "<string>",
      "name": "<string>",
      "url": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

name
string
required

Full or partial name, minimum 3 characters

only_priority
boolean

If true, only returns priority merchants

Response

200 - application/json
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.
merchants
object[]