GoBlinkly

[Superadmin] Returns a one-report upload link valid for 30 minutes, plus a ready curl command. POST the PDF to it as multipart field "file" (PDF only, max 25 MB). The upload attaches the PDF to the report: an awaiting_upload, pending_review or rejected report moves to pending_review, and an approved or sent report is replaced and stays approved. Use this both for new reports and for replacing an existing PDF.

create_monthly_report_upload_link

Creates a Shopify blog row in Goblinkly and starts the generation pipeline for it. The brand must be in Shopify mode with a connected site and a chosen Shopify blog. Nothing is sent to Shopify until the post is saved, published or scheduled.

create_shopify_blog

Creates a Webflow blog row in Goblinkly and starts the existing generation pipeline for that row.

create_webflow_blog

Permanently removes an AEO citation-tracking prompt from a brand — it stops being sampled going forward, though its past run history is kept. Confirm with the user before calling this. Requires citation-tracking write access on the brand.

delete_aeo_prompt

Permanently removes an AEO citation-tracking topic from a brand, including every prompt filed under it — those prompts stop being sampled too, not just the topic, though their past run history is kept. Confirm with the user before calling this. Requires citation-tracking write access on the brand.

delete_aeo_topic

Soft-deletes a task, recording who did it. A brand member can only delete a task they opened themselves; Goblinkly staff can delete any. Requires owner, admin or content editor on the brand; an analyst is refused, the same way the Tasks and Notes pages refuse one.

delete_brand_task

Permanently removes a competitor from a brand, along with its social profiles. The record that it was named in past answers survives, but it stops counting as a tracked competitor: it disappears from share of voice, and stays in the topic rankings only as the raw name the answer used. Prefer excludeFromBlogs through update_competitor when the intent is only to stop mentioning it in content. Confirm with the user before calling this. Requires owner, admin or analyst on the brand.

delete_competitor

Keeps the user value for each suggested token named: the suggestion stops showing until the next extraction. To take the AI value instead, use reset_design_tokens. Owners and admins only.

dismiss_design_suggestions

Reads the brand website's stylesheets, plus up to 3 extra pages, and has the AI fill in the design tokens. Pass 1–2 of the brand’s blog article URLs in urls: the tokens describe how an article looks, and homepages rarely show body text, links or tables, so a homepage-only run is the least accurate. includeWebsite false skips the brand website and reads only urls, for a homepage styled unlike the blog; urls is then required. Takes up to 45 seconds. Never changes tokens the user edited; a different AI value for one shows as a suggestion. A failure (status failed, failureReason blocked, nocss, timeout or ai) leaves every token as it was. A second call for the same brand while one runs is rejected. Owners and admins only.

extract_design_guideline

Returns total AEO sessions and AEO source breakdown data for a brand over a date range.

get_aeo_analytics

Returns paginated AEO citation gaps where the brand is not cited but competitors are.

get_aeo_citation_gaps

Returns the AEO citation trend for a brand over time, bucketed weekly.

get_aeo_citation_trend

Returns AEO citation dashboard KPI cards such as share of voice, average position, and prompts tracked for a brand.

get_aeo_dashboard_kpis

Returns the earliest and latest successful AEO citation data dates currently available for a brand.

get_aeo_data_range

Returns run history for a single AEO prompt, including optional date, engines, and cited-only filters.

get_aeo_prompt_runs

Returns AEO topic rankings, including the top brands per topic and the brand status for each topic.

get_aeo_rankings_by_topic

Returns AEO share-of-voice vs competitors for a brand: { bars, others, expandedBars, expandedOthers, ourBrand, brandPinnedSeparately, totalTrackedCompetitors, mentionsToNextRank }.

get_aeo_share_of_voice

Returns defend-versus-invest topic strategy buckets for AEO citation performance.

get_aeo_topics_strategy

Returns the current AEO citation tracking configuration for a brand.

get_aeo_tracking_config

Returns a brand's full audience profile, including positioning, targeting, and provenance metadata. languages are codes: en (English) or fr-CA (Quebec French).

get_audience_profile

Returns the change history of a brand's audience profile: one entry per create/update/delete, including which fields changed, which user made the change, and whether it came through the API or MCP.

get_audience_profile_change_log

Returns the earliest and latest analytics dates currently available for a brand.

get_available_date_range

Returns the backlink backfill status for a brand, including whether an initial backfill exists and the latest synced date.

get_backlink_backfill_status

Returns the earliest and latest backlink metric dates currently available for a brand.

get_backlink_date_range

Returns backlink summary tiles for a brand, including total backlinks, referring domains, and the new-versus-lost counts in the selected date range.

get_backlink_tiles

Returns backlink and referring-domain trend series for a brand over time, including new and lost counts.

get_backlink_trends

Returns the brand's blog generation settings: brandContext (what every generated blog is written from), brandImageGuidelines (how generated images should look), thumbnailAspectRatio and bodyImageAspectRatio (width:height of generated images) and ctaButton (whether a call-to-action button is appended after each blog, and its colours, border radius, font weight and font size). ctaButtonAvailable is false for brands not on a custom website, where ctaButton and bodyImageAspectRatio are null and cannot be set; there thumbnailAspectRatio applies to every generated image.

get_blog_config

Returns one blog-generation job plus its ordered phase breakdown and latest saved context.

get_blog_generation_job

Returns the configured SEO integrations for a brand, including active GA4 and GSC connection metadata already stored in Goblinkly.

get_brand_integrations

One task in full, including its comment thread and its field-change history — who reassigned it, who moved it to blocked, and when. The brand is read off the task itself, so no brandId is needed. Requires owner, admin or content editor on the brand; an analyst is refused, the same way the Tasks and Notes pages refuse one.

get_brand_task

Returns one competitor by id, including its social profiles. Requires the brandId the competitor belongs to.

get_competitor

Returns the full custom-website blog record for one Goblinkly blog id.

get_custom_blog

Returns full custom-website blog records (same shape as get_custom_blog) for up to 25 blog ids in one call, all from the same brand. Use for fetching a batch of blogs at once instead of one get_custom_blog call per id.

get_custom_blogs_bulk

Returns aggregated dashboard tile metrics for a brand over the requested date range.

get_dashboard_tiles

Returns the brand design guideline (Brand Settings → Design): the brand's one set of design tokens, which the blog CTA button, newsletter emails and the newsletter signup form use whenever their own style fields are empty. tokens maps each key to its value, its origin (edited = a user override, ai = the latest extraction, cta = carried over from the old blog CTA style, default = neutral built-in) and base (the value a reset returns to). suggestions are edited tokens whose latest AI value differs. Also returns customCss, the extraction status (none, ok, partial, failed) with failureReason, coreMissing (the core tokens no extraction has found; any make a result partial), lastExtractedAt, tokensFound, the brand websiteLink and sourceUrls, and the compiled stylesheet's size and hash.

get_design_guideline

Fetches a GA4 Data API report for a brand using a curated dimension allowlist and any standard GA4 metric name, live from Google, capped on dimensions/metrics/date range/rows. For the specific shape of a plain date series with only the sessions/engagedSessions metrics, may return a previously stored daily snapshot instead of a live call — that snapshot's organicSessions/aeoSessions are the organic-search and AI-answer-engine traffic segments only, not total property traffic. Every other dimension/metric combination is always a live call. Optionally narrow server-side with filterDimension/filterValues (in-list match, OR semantics) — filterDimension must also be one of the allowed dimensions, and need not be one of the displayed "dimensions". Filtering on "date" requires filterValues in the same YYYY-MM-DD format as startDate/endDate. A filter forces a live call even for the plain date-series shape. On an error, read "suggestedAction" in the response body — for a bad/disallowed/incompatible dimension, metric, filter, date range, or limit, it tells you exactly what to change; retry with a corrected call rather than giving up or asking the user to rephrase. For rate-limiting or a GA4/system-level failure, it says not to retry — surface that message to the user as-is instead.

get_ga4_custom_report

Returns the GA4 key events (conversions) configured on a brand's connected GA4 property.

get_ga4_key_events

Fetches live GA4 organic and AEO traffic metrics for a brand through Goblinkly using the brand stored Google OAuth tokens.

get_ga4_live_traffic_metrics

Compares Goblinkly stored GA4 data against Google Analytics itself for a date range, returning per-day organic and AEO session drift beyond normal noise. Use this to check whether a reported dashboard discrepancy is actually a sync problem.

get_ga4_sync_health

Fetches a Search Console searchanalytics report for a brand using any combination of GSC's dimensions (date, page, query, country, device, searchAppearance — no cap on how many you combine, this is the whole vocabulary), live from Google, capped on date range/rows. For dimensions=["date"] or ["date","query"], may return previously stored data instead of a live call when the range is fully synced ("date" alone gives clicks/impressions/position only, no ctr; "date"+"query" gives all 4 metrics same as get_gsc_queries) — every other dimension combination (page/country/device breakdowns, which are never stored locally) is always a live call. Rows are sorted by clicks descending, or by date ascending if "date" is one of the dimensions (Google has no other sort control). A response capped at "limit" rows may be hiding more — check "hasMore": if true, issue another call with "startRow" set to the returned "nextStartRow" to fetch the next page, and repeat until "hasMore" is false, so no data silently goes missing; each page is one independent call against GSC's generous 1,200-queries-per-minute quota. Optionally narrow server-side with filterDimension/filterOperator/filterValue — GSC only supports a single value per filter (no OR-of-many-values like the GA4 custom tool); filterOperator defaults to "equals" and also accepts contains/notContains/notEquals/includingRegex/excludingRegex. Combining "page" and "query" together is Google's most expensive query shape (a separate load quota from the request-rate limit), so that combination gets a shorter maximum date range. On an error, read "suggestedAction" in the response body — for a bad/disallowed dimension, filter, date range, or limit, it tells you exactly what to change; retry with a corrected call rather than giving up or asking the user to rephrase. For rate-limiting or a GSC/system-level failure, it says not to retry — surface that message to the user as-is instead.

get_gsc_custom_report