athenahq.ai

Open the AthenaHQ AI crawler access panel.

Check HTTP responses to AI crawler user agents and robots.

List the Default, custom and archived streaming schedules for a website.

AI Search Value for a website: topic-market value, captured value range, headroom, coverage, value-weighted AI share of voice, per-topic detail, and modeled attributed contribution.

List prompts (search queries) tracked for a website

List prompt tags for a website with per-tag prompt counts.

List personas configured for a website with per-persona prompt counts.

List topics (groupings of prompts) for a website, with the count of prompts in each

List competitors tracked for a website

List the Content Hub tabs/sheets configured for a website.

List tracked content (1st-party drafts, imported pages, 3rd-party placements) with citation, mention, and impression metrics for the supplied date range and filters.

Enumerate every content item in a website's Content Hub, published or not: in-flight drafts, briefs, snipes, optimize and slice runs, scheduled and failed items, plus tracked pages.

Fetch the full detail of a single tracked content item — its brief and body text (drafts, optimize rewrites, snipes, authored and scraped pages), plus status, cited source URLs, and links.

For a single tracked content item, list every prompt whose AI responses cited it — with citations, citation %, and estimated impressions.

List every website accessible to the calling session.

List geo-locations configured for a website

Get the earliest and latest response dates for a website

Get LLM responses for a website.

Read the latest (or a specific) response-streaming run's whole-run state and response-queue progress.

Fetch a single LLM response by id with full sources, mentions, and rank details.

List saved views (filter presets) for a website

List group-level saved views (filter presets) shared across the websites in a group

Get credit balance for the organization

Get credit balance for a specific website

List all groups in the organization (global API key only)

Fetch a single group by id with its member websites.

Get cumulative share of voice — overall SOV for each competitor across the date range.

Get share of voice over time — how often the website is mentioned vs competitors, grouped by day.

Get cumulative citation rate — average citation rate for each competitor across the date range.

Get citation rate over time — how often AI models cite (link to) the website, grouped by day.

Get cumulative mention rate — average mention rate for each competitor across the date range.

Get mention rate over time — how often AI models mention the website by name, grouped by day.

Get cumulative position — average ranking position for each competitor across the date range.

Get ranking position over time — average position of the website in AI model responses, grouped by day.

Get position distribution: share of responses where the brand ranks top/middle/bottom across the date range.

Query aggregated metrics for brand performance, competitors, sources, citations, and response trends.

Query individual analytics rows.

List pitch workspace reports for the organization.

Get a pitch report by ID including competitors, prompts, attributes, top citing sources, and aggregate metrics (brand mentions, sentiment, response rate).

List top cited sources (root domains) for a website with citation, mention, brand-mention, and impression metrics.

List individual cited URLs (pages) for a website with citation, mention, and impression metrics plus a per-URL daily sparkline.

List the brand traits (called attributes in the API) tracked for a website: brand-perception keywords such as 'Affordable' or 'Slow Support'.

Get cumulative brand trait (attribute) metrics: for each brand-perception keyword (e.

Get brand trait (attribute) metrics per tracked competitor: for each competitor and each brand-perception keyword (e.

Get the daily trend for ONE brand trait (attribute), brand and competitors side by side — how mentions of a keyword like 'Affordable' moved over time.

Get individual brand trait (attribute) observations: each row is one AI response describing one entity (the brand or a competitor) with one brand trait, including the response excerpt as `text_span`.

Look up a user by email address, scoped to the caller's organization.

When grounding is present, use its complete team-confirmed statement and all supporting facts as joint evidence; the legacy fact ID/text are only a compatibility anchor.

When grounding is present, use its complete team-confirmed statement and all supporting facts as joint evidence; the legacy fact ID/text are only a compatibility anchor.

Add brand facts to a website's Knowledge Base in bulk (1-50 per call).

Add an article that is already written (for example, one drafted in this conversation) to the website's Content Hub as an editable draft.

Approve a content brief and start writing the article from it.

Generate an article or content brief in AthenaHQ.

Create a location for a website

Create a Knowledge Base pillar (a subject area that groups brand facts) from a name and optional description.

Create a prompt tag on a website, or return the existing tag when its name matches case-insensitively.

Create one or more prompts on a website

Create a saved view (filter preset) for a website.

Create a custom source tag with a name and URL patterns.

Create a topic on a website (returns the existing topic when the name is already taken)

Permanently delete 1-50 brand facts from a website's Knowledge Base.

Delete a content row.

Delete a location from a website

Permanently delete 1-20 Knowledge Base pillars and every fact filed under them.

Delete a prompt (soft when responses exist, hard otherwise)

Permanently delete a custom source tag and all its pattern assignments; retain source records.

Delete a topic (soft delete; optionally also delete its prompts)

Apply exact find-and-replace edits to a content draft's article body.

List a website's brand facts from the Knowledge Base, newest first, with offset paging.

Read the current draft text of a content item — the article body as it stands right now, including every revision applied so far.

Get the normalized pipeline status (running | succeeded | failed) for one content row, plus the raw stage behind it.

Read the full text of one saved version of a content item.

List the saved versions of a content item, newest first.

Read recorded organization credit consumption: total, hourly (24h) or daily trend, and charged website/group/organization pools.

Read a page of recorded credit charges/refunds and action labels for the organization, optionally filtered by originatingWebsiteId.

Read the identifiers of the website's brand, or of one competitor: the names, aliases and domains Athena looks for in AI responses to count a mention.

Fetch a pillar's synthesized markdown document from the Knowledge Base.

List a website's Knowledge Base pillars (excluding archived ones) with approved-fact counts, whether a synthesized document exists, and when each pillar was last researched.

Read Discover history and progress for a website, or supply the run ID returned by discovery launch to inspect one study.

Read saved Google organic rankings by explicit market and device alongside observed AI visibility.

Get the Shopping Insights dashboard for a website over a date range: how often the brand's products appear in AI shopping answers (product carousels) versus competitors, average position and price, the top own and competitor products, the competitor leaderboard, retailer (merchant) breakdown, rank distribution, price comparison, and a daily appearances trend.

Read custom source tags, URL patterns, and revision tokens.

Merge 1-20 source pillars into a published target pillar: every fact on the sources (any review status) re-files onto the target, page links carry over keeping the stronger signal, and the source pillars are then deleted.

File 1-50 brand facts under a published Knowledge Base pillar — works for unfiled facts and re-files facts from other pillars.

Move one or more content items to a different Content Hub sheet, or back to the shared pool.

Record an already-published article's URL in AthenaHQ for citation and mention tracking.

Rename a content row's title.

Bring an earlier version's text back as the current draft — use it when a later pass came out worse than an earlier one.

Rewrite a content brief from a natural-language instruction (for example: 'add a section on pricing objections', 'cut the competitor comparison').

Rewrite an existing content draft from a natural-language instruction (for example: 'tighten the intro', 'add a section on pricing', 'remove the second half').

Semantic search over a website's approved brand facts in the Knowledge Base.

Replace all tag assignments on an existing prompt.

Pause or unpause multiple prompts in one transaction

Start a Discover study to find evidence-grounded, untracked prompt opportunities for a website.

Run tracked prompts against external AI providers to collect new responses for a website.

Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them.

Update one brand fact's text, source URL, or confidence in the Knowledge Base.

Add or remove identifiers on the website's brand, or on one competitor, under the same rules as the Competitors page.

Update a location for a website

Update a Knowledge Base pillar's name, description, or status.

Update a prompt's metadata (text, type, topic, geography)

Edit a custom source tag: rename it, add URL patterns, or remove exact patterns returned by the source-tag listing tool.

Update a topic's name or description