# Brandfetch (/examples/tools/brandfetch-tools)



Build with Agno Agents and use Brandfetch API to retrieve a company's brand information.

## Prerequisites [#prerequisites]

* Register an account at: [https://developers.brandfetch.com/register](https://developers.brandfetch.com/register).
* Brand API:
  * Export your API key as an environment variable: `export BRANDFETCH_API_KEY=your_api_key`
* Brand Search API:
  * Export your Client ID as an environment variable: `export BRANDFETCH_CLIENT_ID=your_client_id`
* Export your OpenAI API key: `export OPENAI_API_KEY=your_openai_api_key_here`

```python
"""
* For the Brand API, set `brand` parameter to True. (default: True)
* For the Brand Search API, set the `search` parameter to True. (default: False)

Refer to https://developers.brandfetch.com/dashboard/brand-search-api in the provided URL after `c=...` for details.
"""

import asyncio

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

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------


# Brand API

# agent = Agent(
#     tools=[BrandfetchTools()],
#     description="You are a Brand research agent. Given a company name or company domain, you will use the Brandfetch API to retrieve the company's brand information.",
# )
# agent.print_response("What is the brand information of Google?", markdown=True)


# Brand Search API

agent = Agent(
    tools=[BrandfetchTools(async_tools=True)],
    description="You are a Brand research agent. Given a company name or company domain, you will use the Brandfetch API to retrieve the company's brand information.",
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    asyncio.run(
        agent.aprint_response("What is the brand information of Agno?", markdown=True)
    )
```

## Select the Brand Search API [#select-the-brand-search-api]

Replace `BrandfetchTools(async_tools=True)` with `BrandfetchTools(enable_search_by_brand=True)`. Async methods are selected automatically by `aprint_response`; passing `async_tools` collides with the toolkit's internal argument. The replacement enables name search alongside identifier lookup. `BRANDFETCH_CLIENT_ID` authenticates name search, while `BRANDFETCH_API_KEY` authenticates identifier lookup.

## Run the Example [#run-the-example]

```bash
# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno
git checkout d703c34f3abf3c41275d3fb2da6e0518a8881f24

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate
uv pip install -U openai

python cookbook/91_tools/brandfetch_tools.py
```

For details, see [Brandfetch cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/91_tools/brandfetch_tools.py).