Brand monitoring and mention tracking via the Brand.dev API. Use when asked to monitor brand mentions, track sentiment, find PR opportunities, detect logo usage, or analyze brand presence online. Trigger phrases: "brand monitoring", "mention tracking", "brand sentiment", "PR opportunities", "logo de

Brand Monitor Track brand mentions, analyze sentiment, and discover PR opportunities using the Brand.dev API. Prerequisites Requires BRANDDEV API KEY set in .env , .env.local , or ~/.claude/.env.global . If the key is not set, instruct the user: You need a Brand.dev API key. Get one at https://brand.dev/ Then add BRANDDEV API KEY=your key to your .env file. API Base All requests go to https://api.brand.dev/v1/ with the header Authorization: Bearer {BRANDDEV API KEY} . 1. Brand Search Search for mentions of a brand name across the web. Endpoint Parameters Param Type Description query string Brand name or phrase to search limit int Number of results (default 20, max 100) offset int Pagination offset sort string relevance or date from date string Start date (YYYY MM DD) to date string End date (YYYY MM DD) Example curl Response Parsing 2. Brand Info Lookup Get structured brand information for any company or product. Endpoint Parameters Param Type Description domain string Company domain (e.g., stripe.com ) name string Brand name (alternative to domain) Example curl Response Fields name : Official brand name domain : Primary domain description : Brand description industry : Industry classification founded : Year founded headquarters : Location social profiles : Links to social media logos : Brand logo URLs colors : Brand color palette employees range : Company size estimate 3. Logo Detection Detect brand logos in images across the web. Endpoint Parameters Param Type Description brand string Brand name to search for domain string Filter to specific domain limit int Number of results Example curl Use logo detection to find: Unauthorized logo usage Partner and sponsor visibility Event coverage and media placements Counterfeit product listings 4. Mention Tracking Set up ongoing tracking for brand mentions. Create a Monitor Body Example curl List Monitors Get Monitor Results 5. Sentiment Analysis Analyze sentiment of brand mentions. Endpoint Parameters Param Type Description query string Brand name from date string Start date to date string End date granularity string day , week , or month Example curl Sentiment Scores Positive ( 0.3): Praise, recommendations, positive reviews Neutral ( 0.3 to 0.3): Factual mentions, news coverage Negative (< 0.3): Complaints, criticism, negative reviews 6. Competitor Mention Comparison Compare brand mention volume and sentiment against competitors. Workflow 1. Search mentions for your brand and each competitor 2. Compare mention counts over the same time period 3. Compare sentiment distributions 4. Identify sources where competitors get mentioned but you do not Workflow: Full Brand Audit When asked for a comprehensive brand monitoring report: Step 1: Brand Info Pull structured brand data for context. Step 2: Mention Volume Search for brand mentions over the last 30/90 days. Count total mentions and break down by source type. Step 3: Sentiment Analysis Get sentiment trends. Flag any negative spikes and investigate root causes. Step 4: PR Opportunities From mention data, identify: High authority sites that mention competitors but not you Journalists who cover your industry Trending topics where your brand could contribute Unanswered questions about your brand on forums Step 5: Logo/Visual Presence Search for logo appearances. Flag unauthorized usage. Step 6: Report Present findings as: Error Handling Status Meaning 401 Invalid or expired API key 403 Insufficient permissions for this endpoint 404 Resource not found (check monitor ID) 429 Rate limit exceeded wait and retry 500 Server error retry after a few seconds Tips Use exact brand name + common misspellings as keywords Exclude your own domain to avoid self mentions Set up monitors for competitor brands too Check mentions weekly at minimum; daily during launches or crises Export negative mentions to a spreadsheet for customer support follow up

brand-monitor