First-party app
Brandfetch

Brandfetch

Look up a brand's logos, colors, fonts and company data by domain, ticker, ISIN, crypto symbol or card transaction with Brandfetch.

stable MarketingDeveloper Tools

About

Brandfetch ships in the w6w first-party pack. It declares 9 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.brandfetch
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Marketing · Developer Tools

Overview

Brandfetch turns a company identifier into its brand: logos and icons in SVG, PNG and WebP, the color palette, fonts, imagery, social links, description and company facts (industry, employees, founding year, headquarters, ticker and ISIN).

A workflow can look a brand up by domain, website URL, email address, brand id, stock or ETF ticker, ISIN or crypto symbol, search brands by name, read a brand’s narrative context (positioning, voice and visual style) as JSON or Markdown, and resolve a raw card-transaction label to the merchant behind it. Account usage against the plan’s credit allowance is readable for free.

The connection holds a Brandfetch API key, sent as a bearer token. An optional Brand Search client ID can be added; it is sent only on name searches. The Logo CDN (cdn.brandfetch.io) is not an action: it serves images straight from a URL and needs no call.

Build with Brandfetch

Three routes to the same 9 actions. The Workflow tab is generated from Brandfetch's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Brand

get-brand

Get a brand's logos, colors, fonts, imagery, links and company data from a domain, website URL, email address, brand ID, ticker, ISIN or crypto symbol. Billed per call (a 404 too).

Get Brand by Crypto Symbol

get-brand-by-crypto

Get brand data for a cryptocurrency from its symbol.

Get Brand by Domain

get-brand-by-domain

Get brand data for a domain, with no ticker or crypto-symbol ambiguity. Email addresses and website URLs are refused by this route; use Get Brand for those.

Get Brand by ISIN

get-brand-by-isin

Get brand data for a listed company from its ISIN.

Get Brand by Ticker

get-brand-by-ticker

Get brand data for a listed company from its stock or ETF ticker.

Get Brand Context

get-brand-context

Get a narrative brand profile for a domain: identity, positioning (value proposition, audience, products) and brand voice and visual style, as structured JSON or Markdown ready for an LLM prompt. Billed per call.

Get Brand from Transaction

get-brand-from-transaction

Resolve a raw card or bank transaction label (e.g. "AMZN Mktp US*2K4") to the merchant's brand: name, domain, logos and company data. Billed per call.

Get API Key Usage

get-viewer

Read the connected API key's name, organization and credit usage (used / quota) for the current billing period. Free: it never consumes credits.

Search Brands

search-brands

Search brands by company name; returns the brand ID, name, domain and icon of each match, best first. Feed a hit's domain to Get Brand for the full profile.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Brandfetch's real ids.

{
  "manifestVersion": "2",
  "name": "brandfetch-example",
  "steps": [
    {
      "id": "get-brand",
      "uses": {
        "app": "io.w6w.brandfetch",
        "action": "get-brand",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "identifier": "<identifier>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Brand

    read
    get-brand
  • Get Brand by Crypto Symbol

    read
    get-brand-by-crypto
  • Get Brand by Domain

    read
    get-brand-by-domain
  • Get Brand by ISIN

    read
    get-brand-by-isin
  • Get Brand by Ticker

    read
    get-brand-by-ticker

+4 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Brandfetch, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Brandfetch. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "get-brand",
  payload: {
    identifier: "<value>",
    // allowNsfw: "<value>",
    // cachedOnly: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action get-brand --payload '{"identifier":"<value>"}'

Give an AI agent Brandfetch — without giving it Brandfetch's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.brandfetch#get-brand",
    "input": {
      "identifier": "<identifier>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Brandfetch connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Brandfetch's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Brandfetch itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Brandfetch declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Brandfetch status

Status of the Brand API, Brand Context API and Search API on status.brandfetch.io (Better Stack). Other resources are shown but do not drive the verdict.

dependency

API reachable

Unauthenticated GET /v2/viewer. Brandfetch's JSON `Unauthorized` refusal passes: it proves the application is answering.

quota

API credit headroom

Credits used vs the plan allowance, from the free GET /v2/viewer.