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).
Categories: Sales · Enrichment · Marketing · Auth: API Key · Actions: 2
Authentication
API Key Authentication
Authenticate using your Brandfetch API key1
Step 1
Sign up or log in at https://developers.brandfetch.com
2
Step 2
Open your dashboard and locate your API key
3
Step 3
Copy the API key and paste it below
Required Credentials
| Field | Description | Required | Format |
|---|---|---|---|
| Brandfetch API Key | Your Brandfetch API key from the developer dashboard | Yes | - |
Available Actions
get_brand — Retrieve brand assets including logos, colors, fonts, and company info by domain, ticker, ISIN, or crypto symbol.
get_brand — Retrieve brand assets including logos, colors, fonts, and company info by domain, ticker, ISIN, or crypto symbol.
Parameters
string
required
Brand identifier: domain (nike.com), stock ticker (NKE), ISIN (US6541061031), or crypto symbol (BTC)
Response
{
"$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"
}
search — Search for brands by name and find their domains and logos.
search — Search for brands by name and find their domains and logos.
Parameters
string
required
Company or brand name to search for
Response
{
"$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"
}
Limits & Quotas
- Rate limit: approximately 30 requests/minute.
- Brand API (
get_brand): metered per request on paid tiers; requests for thebrandfetch.comdomain 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+errorrather than raising. Plan for retries on the agent side based on the error string.