> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Brandfetch Integration for AI Agents & Workflows

> Integrate Brandfetch into your workflow. Retrieve brand logos, colors, fonts, and company data by domain, ticker, or name search.

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/df8MOr-hXotYLTh5/logos/placeholder.svg?fit=max&auto=format&n=df8MOr-hXotYLTh5&q=85&s=a4046f9cd6d738c81259050e9833913c" alt="Brandfetch logo" width="72" height="72" data-path="logos/placeholder.svg" />

## Overview

Add **Brandfetch** to any ModuleX agent or workflow. Look up brand assets, logos, colors, fonts, and company firmographics by domain, ticker, ISIN, or crypto symbol — and resolve brand names to domains — against the Brandfetch REST API (`api.brandfetch.io`).

<Info>
  **Categories**: Sales · Enrichment · Marketing · **Auth**: API Key · **Actions**: 2
</Info>

## Authentication

### API Key Authentication

Authenticate using your Brandfetch API key

<Steps>
  <Step title="Step 1">
    Sign up or log in at [https://developers.brandfetch.com](https://developers.brandfetch.com)
  </Step>

  <Step title="Step 2">
    Open your dashboard and locate your API key
  </Step>

  <Step title="Step 3">
    Copy the API key and paste it below
  </Step>
</Steps>

#### Required Credentials

| Field              | Description                                          | Required | Format |
| ------------------ | ---------------------------------------------------- | -------- | ------ |
| Brandfetch API Key | Your Brandfetch API key from the developer dashboard | Yes      | `-`    |

## Available Actions

<AccordionGroup>
  <Accordion title="get_brand — Retrieve brand assets including logos, colors, fonts, and company info by domain, ticker, ISIN, or crypto symbol.">
    ### Parameters

    <ResponseField name="identifier" type="string" required>
      Brand identifier: domain (nike.com), stock ticker (NKE), ISIN (US6541061031), or crypto symbol (BTC)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "BrandColor": {
          "additionalProperties": false,
          "description": "A brand color with its hex value and role.",
          "properties": {
            "hex": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Hex"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "brightness": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Brightness"
            }
          },
          "title": "BrandColor",
          "type": "object"
        },
        "BrandFont": {
          "additionalProperties": false,
          "description": "A brand font with its name, role, and origin.",
          "properties": {
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "origin": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Origin"
            },
            "origin_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Origin Id"
            },
            "weights": {
              "items": {
                "type": "integer"
              },
              "title": "Weights",
              "type": "array"
            }
          },
          "title": "BrandFont",
          "type": "object"
        },
        "BrandLink": {
          "additionalProperties": false,
          "description": "A single social/website link entry.",
          "properties": {
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Url"
            }
          },
          "title": "BrandLink",
          "type": "object"
        },
        "BrandLogo": {
          "additionalProperties": false,
          "description": "A logo asset with its theme and available formats.",
          "properties": {
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "theme": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Theme"
            },
            "formats": {
              "items": {
                "$ref": "#/$defs/BrandLogoFormat"
              },
              "title": "Formats",
              "type": "array"
            }
          },
          "title": "BrandLogo",
          "type": "object"
        },
        "BrandLogoFormat": {
          "additionalProperties": false,
          "description": "One downloadable format for a logo asset.",
          "properties": {
            "src": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Src"
            },
            "format": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Format"
            },
            "width": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Width"
            },
            "height": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Height"
            },
            "background": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Background"
            },
            "size": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Size"
            }
          },
          "title": "BrandLogoFormat",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "domain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Domain"
        },
        "claimed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Claimed"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "long_description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Long Description"
        },
        "links": {
          "items": {
            "$ref": "#/$defs/BrandLink"
          },
          "title": "Links",
          "type": "array"
        },
        "logos": {
          "items": {
            "$ref": "#/$defs/BrandLogo"
          },
          "title": "Logos",
          "type": "array"
        },
        "colors": {
          "items": {
            "$ref": "#/$defs/BrandColor"
          },
          "title": "Colors",
          "type": "array"
        },
        "fonts": {
          "items": {
            "$ref": "#/$defs/BrandFont"
          },
          "title": "Fonts",
          "type": "array"
        },
        "company": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Company"
        },
        "quality_score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Quality Score"
        },
        "is_nsfw": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Is Nsfw"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetBrandOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="search — Search for brands by name and find their domains and logos.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Company or brand name to search for
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "SearchResultItem": {
          "additionalProperties": false,
          "description": "A single brand match returned by ``search``.",
          "properties": {
            "brand_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Brand Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "domain": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Domain"
            },
            "claimed": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Claimed"
            },
            "icon": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Icon"
            }
          },
          "title": "SearchResultItem",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "results": {
          "items": {
            "$ref": "#/$defs/SearchResultItem"
          },
          "title": "Results",
          "type": "array"
        },
        "total_results": {
          "default": 0,
          "title": "Total Results",
          "type": "integer"
        }
      },
      "required": [
        "success"
      ],
      "title": "SearchOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Rate limit**: approximately 30 requests/minute.
* **Brand API** (`get_brand`): metered per request on paid tiers;
  requests for the `brandfetch.com` domain are free.
* **Brand Search API** (`search`): free under fair use (up to \~500,000
  requests/month).
* **Error model**: non-2xx responses and timeouts are caught and
  returned as `success=False` + `error` rather than raising. Plan for
  retries on the agent side based on the error string.

## Related integrations

<CardGroup cols={3}>
  <Card title="Clay" href="/integrations/tools/clay" />

  <Card title="Dropcontact" href="/integrations/tools/dropcontact" />

  <Card title="Enrow" href="/integrations/tools/enrow" />
</CardGroup>

## Links

* [Brandfetch](https://brandfetch.com)