Skip to main content
GET
/
api
/
brands
/
search
Search Brands
curl --request GET \
  --url https://api.merchantops.ai/api/brands/search
{
  "items": [
    {
      "id": "<string>",
      "key": "<string>",
      "name": "<string>",
      "aliases": [
        "<string>"
      ],
      "createdAt": "<string>",
      "createdBy": "<string>",
      "domain_patterns": [
        "<string>"
      ],
      "is_verified": false,
      "lastModifiedAt": "<string>",
      "lastModifiedBy": "<string>",
      "llm_inferred_url": "<string>",
      "logo_url": "<string>",
      "scrape_consecutive_failures": 0,
      "scrape_disabled_until": "<string>",
      "scrape_last_failure_at": "<string>",
      "scrape_last_failure_reason": "<string>",
      "scrape_mode": "auto",
      "scrape_mode_set_at": "<string>",
      "scrape_mode_set_by": "<string>",
      "source": "<string>",
      "url_needs_review": false,
      "urls": [
        {
          "country": "<string>",
          "url": "<string>"
        }
      ],
      "web_search_url": "<string>"
    }
  ],
  "query": "<string>",
  "total": 123
}

Headers

authorization
string | null
X-Organization-ID
string | null

Query Parameters

q
string
required

Search query

Minimum string length: 1
limit
integer
default:10

Max results

Required range: 1 <= x <= 50
verified_only
boolean
default:false

Only search verified brands

Cookies

stytch_session
string | null

Response

Successful Response

Response model for search results.

items
BrandResponse · object[]
required

Search results

query
string
required

Search query

total
integer
required

Number of results