NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Brandfetch connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Brandfetch actions, such as "Get Brand Information", "Get GraphQL API Version" and "Get Brandfetch Taxonomy". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Brandfetch, with input parameters and output schema.
BRANDFETCH_GET_BRAND_INFORetrieves brand information including logos, colors, fonts, and company details using a domain, Brand ID, ISIN, or stock ticker. Logo data may be absent for some domains — do not assume logos are always returned. The response includes multiple logo types (e.g., icon, logo) and themes; explicitly select the desired type and size rather than defaulting to the first URL.
Input parameters
Identifier to retrieve brand data. Can be a domain (e.g., 'nike.com'), Brand ID (e.g., 'id_0dwKPKT'), ISIN (e.g., 'US6541061031'), or Stock Ticker (e.g., 'NKE') For best results, use an exact domain or Brand ID. If only a vague brand name is available, run BRANDFETCH_SEARCH_BRANDS first to obtain the correct identifier — ambiguous inputs may return wrong or empty results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BRANDFETCH_GET_GRAPHQL_VERSIONTool to retrieve the Brandfetch GraphQL API version. Use when you need to check the current API version via the GraphQL endpoint.
Input parameters
GraphQL query string to retrieve the API version
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BRANDFETCH_GET_TAXONOMYTool to retrieve Brandfetch's taxonomy via GraphQL API. Use this to get a complete list of industries, countries, and geographic regions used in Brandfetch's classification system. The taxonomy includes hierarchical industry data with parent-child relationships.
Input parameters
GraphQL query string for taxonomy data. The taxonomy query can return three fields: industries (list of Industry objects with id, urn, name, slug, emoji, depth, children, parent, banner), countries (list), and geographicRegions (list). You can customize which fields to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BRANDFETCH_GET_TRANSACTION_INFOThis 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.
Input parameters
ISO 3166-1 alpha-2 country code where the transaction took place
The raw transaction text from credit card statement
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BRANDFETCH_LIST_SUBSCRIBABLE_EVENTSTool to retrieve all available webhook event types that can be subscribed to via the Brandfetch GraphQL API. Returns event names and descriptions for webhook configuration. Available events include brand.claimed, brand.deleted, brand.updated, brand.company.updated, and brand.verified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BRANDFETCH_LIST_WEBHOOKSTool to retrieve a list of all webhooks via GraphQL API. Use when you need to query webhook configurations and their statuses in the Brandfetch system.
Input parameters
GraphQL query string to list webhooks. Default query retrieves all webhooks with their urn, url, description, and enabled status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BRANDFETCH_SEARCH_BRANDSSearches for brands by name and returns matching brand information including URLs and icons, enabling rich autocomplete experiences. Use this tool first to resolve a vague name or ticker to a precise domain or brandId before calling BRANDFETCH_GET_BRAND_INFO or BRANDFETCH_GET_LOGO. Results may include multiple candidates; disambiguate using the domain, geography, qualityScore, and verified fields rather than defaulting to the first result. Returns empty results for new or niche brands.
Input parameters
The brand name to search for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 7 Brandfetch actions on Nagent, including "Get Brand Information", "Get GraphQL API Version" and "Get Brandfetch Taxonomy". Get Brand Information: Retrieves brand information including logos, colors, fonts, and company details using a domain, Brand ID, ISIN, or stock ticker. Each action is listed on this page with its input parameters and its output.
Brandfetch connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Brand Information takes 1 required input: identifier. It returns data, error and successful.