Marketing & Social Media

Brandfetch

Learn how to use Brandfetch with Composio

Overview

SLUG: BRANDFETCH

Description

Brandfetch offers an API that retrieves company logos, brand colors, and other visual assets, helping marketers and developers maintain consistent branding across apps

Authentication Details

full
stringDefaults to https://api.brandfetch.io/v2Required
generic_api_key
stringRequired

Connecting to Brandfetch

Create an auth config

Use the dashboard to create an auth config for the Brandfetch toolkit. This allows you to connect multiple Brandfetch accounts to Composio for agents to use.

1

Select App

Navigate to Brandfetch.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Brandfetch Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4brandfetch_auth_config_id = "ac_YOUR_BRANDFETCH_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Brandfetch for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, brandfetch_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Brandfetch toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["BRANDFETCH"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Get Brand Information

Description

This tool retrieves comprehensive brand information including logos, colors, fonts, and company details for any brand using their domain name, brand id, isin, or stock ticker symbol. it provides access to a brand's complete visual identity and company information.

Action Parameters

identifier
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company Information

Description

This action retrieves detailed company information for a given brand identifier. while the brandfetch get brand info tool provides general brand information, this tool specifically focuses on extracting and returning the company-related firmographic data from the response.

Action Parameters

identifier
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Transaction Info

Description

This tool converts payment transaction labels into detailed merchant brand information. it takes a transaction label (like what you see on your credit card statement) and returns comprehensive brand data (including logos, colors, fonts, and company information). it is useful for identifying merchants and enriching transaction data with detailed brand information.

Action Parameters

countryCode
stringRequired
transactionLabel
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Identify Merchant from Transaction

Description

This tool identifies merchant brands from raw transaction data in a single call. it processes unstructured payment text (e.g., credit card transaction descriptions), maps it to a domain, and returns comprehensive brand details including name, logo, domain, and industry information.

Action Parameters

country_code
stringRequired
transaction_label
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search Brands

Description

This tool allows searching for brands by name and returns matching brand information. it enables searching and matching brand names to their corresponding urls and icons, providing rich autocomplete experiences.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired