Sign in

v2

latestOpenAPI 3.0.1MIT2026-07-3191762.1 KB
brands

Get brand data from a transaction

Turn payment transactions into merchant data

post/v2/brands/transaction

Request body

transactionLabelstring required

The raw transaction text.

countryCodestring required

An ISO 3166-1 alpha-2 country code indicating the country where the transaction took place.

Example request

{
  "transactionLabel": "STARBUCKS 1523 OMAHA NE",
  "countryCode": "US"
}

Response

Successful request.

idstring

Unique identifier for the brand

namestring nullable

Brand name

domainstring

Brand website URL

claimedboolean

Set to true if the owner of the brand claimed its brand profile on Brandfetch

descriptionstring nullable

Brand description

longDescriptionstring nullable

Brand long description

qualityScorenumber

Score between 0-1 which indicates the quality of the data for the given brand. Useful when you don't want to show lower quality brands to your users.

Lower 3rd is poor quality, middle 3rd is OK quality, upper 3rd is high quality. Lower scores indicate that a brand is less likely to be "real". For example, where google.com will score high, my-random-blog.com will score between 0.3-0.4. The score factors in things like data-recency, whether the brand has been claimed, if it has been manually verified by our team, the brand's domain ranking on the web, as well as other factors.

Don't rely on a fixed score for any given brand. The way we calculate this score may change over time as we add new factors, or tweak the weights of existing ones such that a score for a given brand may change. However, they will remain aligned such that scores divide quality into thirds: low, medium, high.

isNsfwboolean

true when the brand is for adult content, e.g. is not safe for work

urnstring

Uniform Resource Name for the brand