Search Brands

brandfetch.search_brands
ActionBusiness appsconnection required

Calls the Brandfetch API with the connection's credentials.

Match a company name to candidate brands, each with its domain and an icon URL, for autocomplete.

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Brandfetch
Secret shape
the API key, or {"api_key": "…"}
Config it needs
client_id
Resolved by
config.connection_id, else node.connection_id

Configuration

1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
name
The company name to search for, as typed by a person.
stringYes——Brandfetch

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "name": "Brandfetch"
}

Output

One shape.

result

FieldTypeExample
brands
The matching brands, best match first.
array—
count
How many matches the search returned.
number—
brands[].brandId
Brandfetch's id for the matched brand.
string—
brands[].name
The matched brand's name.
string—
brands[].domain
The matched brand's domain.
string—
brands[].icon
A ready-to-use icon URL for the brand.
string—
brands[].claimed
True when the brand's owner claimed it.
boolean—
{
  "brands": [
    {
      "brandId": "",
      "claimed": false,
      "domain": "",
      "icon": "",
      "name": ""
    }
  ],
  "count": 0
}

Notes

  • This endpoint takes the connection's public clientId on the query string and no bearer token; set 'client_id' on the connection or Brandfetch may throttle the request.

See Search Brands run in a workflow.

In a technical demo we add the Brandfetch connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.