Brandfetch

BrandfetchTools provides access to brand data and logo information through the Brandfetch API.

Prerequisites

The following example requires the openai library and a Brandfetch API key.

uv pip install agno openai
export BRANDFETCH_API_KEY="your_api_key"

The Agent model uses an OpenAI key, separately from any toolkit provider credentials.

Set OpenAI Key

Set your OPENAI_API_KEY as an environment variable. You can get one from OpenAI.

export OPENAI_API_KEY=sk-***

Example

The following agent can search for brand information and retrieve brand data:

from agno.agent import Agent
from agno.tools.brandfetch import BrandfetchTools

agent = Agent(
    instructions=[
        "You are a brand research assistant that helps find brand information",
        "Use Brandfetch to retrieve logos, colors, and other brand assets",
        "Provide comprehensive brand information when requested",
    ],
    tools=[BrandfetchTools()],
)

agent.print_response("Find brand information for Apple Inc.", stream=True)

Toolkit Params

ParameterTypeDefaultDescription
api_keyOptional[str]NoneBrandfetch API key. Uses BRANDFETCH_API_KEY if not set.
client_idOptional[str]NoneBrandfetch Client ID for search. Uses BRANDFETCH_CLIENT_ID.
base_urlstr"https://api.brandfetch.io/v2"Brandfetch API base URL.
timeoutOptional[float]20.0Request timeout in seconds.
enable_search_by_identifierboolTrueEnable searching brands by domain/identifier.
enable_search_by_brandboolFalseEnable searching brands by name.
allboolFalseEnable all tools.

Toolkit Functions

FunctionDescription
search_by_identifierSearch for brand data by domain, brand ID, ISIN, or stock ticker.
search_by_brandSearch for brands by name (requires client_id).

Async versions of both functions run automatically when you call agent.arun() or agent.aprint_response().

Developer Resources