Skip to main content
Requests to the Transaction API count against your Brand API usage quotas.
The Transaction API identifies merchant brands from raw transaction data in a single call. It processes unstructured payment text, maps it to a domain, and returns brand details (e.g., name, logo, domain, industry, etc). For more details, refer to our API Reference. Transaction API works in real-time to recognize merchants worldwide. If a brand is not part of our dataset, it will index the information live, providing data for brands of every size, geography, or sector.

Implementation guide

For more details, refer to our API Reference.
1

Get your API key

You’ll need to create an account on our Developer Portal. Creating an account is quick and easy, and will give you access to your dashboard where you’ll find your API key.
2

Make your first API call

Implement or run the code below to make your first API request.
curl --request POST \
  --url https://api.brandfetch.io/v2/brands/transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "transactionLabel": "STARBUCKS 1523 OMAHA NE",
    "countryCode": "US"
  }'
Authentication is done by passing your API key as a Bearer Authentication. The Transaction API can be accessed through the following structure:
3

Test and deploy

All requests for the domain brandfetch.com are free and will not count towards your usage/quotas. You can make as many requests to the Brandfetch’s brand as you need while you iterate on and test your integration.Once you are ready to go live, simply replace brandfetch.com with the domain name, Stock Ticker or ISIN you want to look up.

Transaction input

The primary input for querying the Transaction API is a raw transaction descriptor (the line-item text on a bank or credit card statement). You provide this as the transactionLabel in the request body, along with a countryCode to narrow down the merchant’s locale. For example, a transaction label like "STARBUCKS 1523 OMAHA NE" with country code "US" can be resolved to starbucks.com.

API Reference

For more details, refer to our API Reference.