Tool Reference
Complete API documentation for all 4 Agentcy tools. Parameters, example queries, and response formats.
marketing_data
Query marketing data and analyze any website — analytics, SEO, advertising, e-commerce, CRM, social media, site health & brand identity, competitive intelligence, content creation, and data visualization. Always use a single call, even when the question spans multiple data sources or channels (e.g., GA4 + Google Search Console + Google Ads + CRM). The server auto-routes internally to all needed sources and returns a combined response with the same depth and granularity as individual queries — do NOT split multi-source or multi-channel questions into separate calls.
| Parameter | Type | Description |
|---|---|---|
request | string | Natural language question. Include everything you need in one question — all channels, metrics, date ranges, and data sources. For example, "Give me website traffic from GA4, organic search performance from GSC, and paid search results from Google Ads for March 2026" is a single valid request. Never break a multi-part question into separate calls.Required |
domain | string | Domain to query (e.g., "example.com"). Optional — if omitted, the server uses your default domain. Always ask the user which domain if not obvious from context. |
start_date | string | Start date: YYYY-MM-DD or relative (e.g., '30daysAgo').Default: 30 days ago |
end_date | string | End date: YYYY-MM-DD or relative (e.g., 'today', 'yesterday').Default: yesterday |
source_hints | string[] | Preferred data sources. If omitted, server auto-selects via semantic routing. |
reference_images | string[] | URLs of reference images (max 5) for image generation — logos, product photos, brand colors, style references. Use to maintain brand consistency across generated visuals. |
Query
Use the marketing_data tool:
request: "How is organic traffic trending this month?"
domain: "aurora-fitness.com"
start_date: "30daysAgo"Response
Organic Traffic Analysis — aurora-fitness.com
Last 30 Days vs Previous Period
• Sessions: 12,847 (+18.3%)
• Top landing page: /protein-powder-guide (2,104 sessions)
• Avg position improved: 14.2 → 11.8
• New keywords ranking: 47 new terms in top 20
• Conversion rate: 3.2% (up from 2.8%)
Recommendation: Your protein powder guide is driving
significant growth. Consider expanding the content
cluster with related long-tail topics.
Sources: GA4, Google Search Consoleresearch
Research any topic — search 100+ engines, read webpages, extract YouTube transcripts. Works without a domain. Use for general research, competitor analysis, or content extraction.
| Parameter | Type | Description |
|---|---|---|
request | string | Natural language research question.Required |
domain | string | Optional domain for context (e.g., "example.com"). Helps focus competitor research. |
Query
Use the research tool:
request: "What pricing strategies are competitors
using for protein supplements?"
domain: "aurora-fitness.com"Response
Competitor Pricing Analysis — Protein Supplements
Top 5 competitors analyzed:
1. GNC — Premium tier ($45-60/lb), loyalty discounts
2. Optimum Nutrition — Mid-range ($30-40/lb), bundle deals
3. MyProtein — Value ($20-30/lb), aggressive sales
4. Transparent Labs — Premium ($50+/lb), quality focus
5. Ghost — Lifestyle ($35-45/lb), brand partnerships
Key patterns:
• Subscribe-and-save (15-25% off) is universal
• Bundle pricing drives 30%+ higher AOV
• Free shipping thresholds: $49-75 range
Sources: 12 web pages, 3 YouTube reviewslist_sources
List available data sources and configured domains. Call this to discover which services and domains are available before querying. If exactly one domain exists, use it automatically without asking.
| Parameter | Type | Description |
|---|---|---|
domain | string | Domain to filter by. If omitted, lists all configured domains and global services. |
Query
Use the list_sources tool
(no parameters required)Response
Configured domains:
- aurora-fitness.com: ga4, gsc, google_ads, woocommerce
- northpeak-outdoor.com: ga4, gsc, spyfu
Global services (available for all domains):
- web_intelligence (Research)
- nano_banana (Image Generation)
- pagespeed (PageSpeed)
- dns_lookup (DNS Lookup)
Service IDs can be used as source_hints.get_current_date
Get the current date, day of week, and timezone. Useful for constructing date ranges in queries.
No parameters required.
Query
Use the get_current_date tool
(no parameters required)Response
Date: 2026-04-23
Day: Thursday
TZ: UTC (UTC, UTC+0)