get_brand
ChatGPTFetch a single brand by its prefixed id (
brn_xxx).Business
Overview
42A tracks how often your brand and your competitors come up in answers from AI search engines like ChatGPT, Gemini, Claude, and Perplexity. Once you connect this app, you can ask things like how your visibility changed over the past week, who's getting mentioned the most in your category, which sites the LLMs are citing, or what needs fixing on your website so it shows up better in AI answers. The data is pulled live from your 42A account. You just sign in. The app can only read your data, it can't change or delete anything.
Tools
get_brand_stats
ChatGPTAggregate visibility stats for a single brand over an arbitrary date range (
from / to, defaults to today), including a daily history series and trend deltas vs the prior window of the same length. Use this to answer "how did brand X do this week?" / "how many times was brand X mentioned?" / "what's brand X's sentiment trend?". For metrics aggregated across the whole org (own + competitors), use get_org_vitals instead.get_category_vitals
ChatGPTPer-prompt-category visibility breakdown, aggregated across all tracked brands in the org (own + competitors). Items are sorted by
visibility_score desc — the first item is the org's strongest "vertical". Use this to answer "what is my strongest vertical?". For a single brand's numbers, use get_brand_stats instead.get_me
ChatGPTIdentity of the authenticated principal plus accessible orgs.
get_org_vitals
ChatGPTAggregate visibility metrics rolled up across all tracked brands in the org (own + competitors) over an arbitrary date range (
from / to, defaults to today). Useful for "how is my industry / tracked set doing in AI answers, in aggregate?". For a single brand's numbers use get_brand_stats instead — that's almost always what you want for "how is my brand doing".get_project
ChatGPTFetch a single analysis project by its prefixed id (
prj_xxx).get_prompt
ChatGPTFetch a single prompt template by its prefixed id (
prm_xxx).list_brands
ChatGPTList brands tracked by an organization. Pass
organization_id to scope to a specific org.list_citations
ChatGPTList citations for an organization. Exactly one of project_id, prompt_id, or website_id is required so the query hits a covering index. Pass
organization_id to scope to a specific org.list_general_vitals
ChatGPTSite-wide GEO/SEO/AEO health checks for a brand's website — robots.txt setup, llms.txt presence, sitemap quality, AI crawler access (GPTBot, ClaudeBot, etc.), canonical configuration, schema markup, and similar global features. Returns the latest score per check sorted worst-first so the caller immediately sees what to fix. THIS is the default tool for any "what should I improve on my website?", "quick fixes to rank better in LLMs", "audit my site for AI search", "what's hurting my AI visibility?", or "GEO recommendations" question. Site-wide config is cheaper to fix and higher-leverage than per-page tweaks; only fall back to
list_page_vitals if the user explicitly asks about specific URLs or after list_general_vitals flagged something page-level. brand_id is required.list_organizations
ChatGPTList the organizations the caller can access. For org keys this is one element; for user keys it's every org the user belongs to. Use the returned
id field as organization_id on other tools to scope calls.list_page_vitals
ChatGPTPer-page feature scores — one row per tracked URL on the brand's site. Use ONLY when the question is about specific pages: "which page has the lowest score?", "what's wrong with /pricing?", "which URLs aren't rendering for LLMs?", or as a follow-up after
list_general_vitals flagged something page-level. For general "what should I improve on my website?" / "audit my site" / "quick fixes for AI visibility" questions, call `list_general_vitals` instead — that covers site-wide config which is what most "improvements" questions actually mean. Sort with sort: "score_low" to surface the worst-scoring pages. brand_id is required.list_projects
ChatGPTList analysis projects (configurations) for an organization. Sorted newest first. Pass
organization_id to scope to a specific org (required for user keys belonging to multiple orgs).list_prompts
ChatGPTList prompt templates for an organization. Sorted newest first. Pass
organization_id to scope to a specific org.list_top_brands_in_project
ChatGPTLeaderboard of brands by mention count in a project's analysis window. Use this to answer "what are the top X mentioned brands in project Y?". Default limit is 10.
list_top_brands_in_prompt
ChatGPTLeaderboard of brands by mention count for a single prompt template. Use this to answer "top brands mentioned in prompt X?" - useful for understanding which brands a particular prompt tends to surface.
list_top_brands_in_topic
ChatGPTLeaderboard of brands by mention count for a single topic - across every prompt in your org classified under that topic. Use this to answer "who is the best mentioned brand in topic X?". Call list_topics first to discover the topic id.
list_top_prompts_in_project
ChatGPTLeaderboard of prompt templates by mention count in a project's analysis window. Use this to answer "what are the top prompts in project Y?" or "which prompts drove the most mentions last week?". Returns name + category + version + is_active for each prompt.
list_top_websites_in_project
ChatGPTLeaderboard of websites by citation count in a project's analysis window. Use this to answer "what are the top X cited websites in project Y in the past week?".
list_top_websites_in_topic
ChatGPTLeaderboard of websites by citation count for a single topic - across every prompt in your org classified under that topic. Use this to answer "what are the top cited domains in topic X?". Call list_topics first to discover the topic id.
list_top_websites_in_vertical
ChatGPTTop cited websites in a vertical (prompt-template category). Use this to answer "top cited domains in X vertical". Aggregates across every prompt template in the org with the matching category. Allowed categories: awareness, consideration, comparison, technical.
list_topics
ChatGPTList the topics that classify your org's prompt templates. Topics are auto-generated by an LLM classifier and group prompts by subject (e.g. "AI Coding Assistants", "CRM software"). Returns id + slug + name + description for each.
