Read LLM Pulse AI visibility metrics, mentions, citations, answers and traffic, and manage its projects, prompts, competitors, tags and annotations.
Explore 97 workflow actions for LLM Pulse, including account permissions and operation limits.
77 read actions20 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Accept catalog prompt suggestions
Write
Starts tracking pending suggestions: each one becomes a prompt, tagged with a collection named after its product.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Accept or reopen a GEO audit issue
Write
Requires a readwrite scope API key and, for team members, update permission on GEO Optimization.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Account plan, quota usage and rate limits
Read
Returns the account plan, tracking cadence, subscription window, how much of each quota is used (prompts, projects, competitors per project, monthly GEO Writer tasks, team members, active recurring.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Add a competitor
Write
Adds a competitor with its own citation URL matching rule.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Aggregated metrics summary
Read
Same as /metrics/timeseries but adds a summary block with total/min/max/last per metric per actor, plus a positiondistribution block (Position 1, Position 2, Position 3+).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
AI bot catalog (Scale plan or above)
Read
Static catalog of AI bots that Agent Analytics can identify.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
AI bot crawler traffic (Scale plan or above, Beta)
Read
Aggregated AI bot traffic hitting the project's origin server (GPTBot, PerplexityBot, ClaudeBot, OAI-SearchBot, Google-Extended, etc.).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
AI Model Insights summary
Read
Per-model mentions, citations, brand net sentiment with raw counts, weighted visibility totals/shares, plus actor matrices.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
AI referral traffic (Scale plan or above)
Read
AI referral traffic for a project: human visits arriving from AI assistants (ChatGPT, Perplexity, Gemini, Claude, etc.), measured from the connected web analytics provider (Google Analytics 4, Adobe.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Bulk-attach tags to prompts
Write
Idempotent bulk assignment of tags (Collections) to existing prompts.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Bulk-create prompts
Write
Add prompts to a project in bulk (up to 100 per request).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Cited URL cached content
Read
Unavailable page content keeps the cited URL and citation metrics.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Cited URL detail
Read
Unavailable page content keeps the cited URL and citation metrics.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Cited URL occurrences
Read
Cited URL occurrences
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Compare two GEO audit runs
Read
Compare two GEO audit runs
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Competitor details
Read
Competitor details
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Create a project (fast mode)
Write
Create a complete project in one call: project fields, prompts (queued for execution and categorization), collections tagging those prompts, competitors, weekly email subscription.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a tag
Write
Creates a tag (Collection) in a project.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a timeline annotation
Write
Marks a date in the project timeseries with a title + description.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete (archive) a GEO audit
Write
Archives the audit.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a competitor
Write
Deletes a competitor (irreversible).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a prompt
Write
Deletes a prompt (irreversible).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a tag
Write
Deletes a tag/collection.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a timeline annotation
Write
Deletes an annotation.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get a custom AI study
Read
One study with its brief, the subjects it compares, the dimensions it scores them on, and its report history.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get a GEO audit
Read
Get a GEO audit
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get a GEO audit run
Read
Get a GEO audit run
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get a GEO Writer task
Read
Get a GEO Writer task
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get a technical GEO report
Read
Returns the current status and the full resultdata once the report is completed.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get custom study report scores
Read
One custom-study report's scores as flat rows: one row per analyst model, subject, dimension and attribute, with its 0-100 score and the reasoning the model gave.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get one AI response
Read
Full answer with mentions, citations, sentiments, sources, shoppingproducts, brandentities, fanoutqueries.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get recommendation run with items
Read
Get recommendation run with items
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Get reputation report scores
Read
One reputation report's scores as flat rows: one row per analyst model, brand, dimension and attribute, with its 0-100 score and the reasoning the model gave.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Google AI Overview result availability
Read
Google AI Overview result availability
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Grouped citation intelligence
Read
Grouped citation intelligence by url / domain / host with per-model breakdown, citation rate, and avg citation position.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Health check
Read
Validates the API key and optionally pings a project.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List AI ad placements
Read
Paid placements returned inside AI answers.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List AI responses
Read
Successful prompt-execution responses with truncated content (max 10,000 chars).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List all citations (brand + competitor)
Read
Unified citations stream with an actortype field on each record.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List all mentions (brand + competitor)
Read
Unified mentions stream.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List brand citations
Read
Includes visible citations and background source references.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List brand mentions
Read
List brand mentions
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List catalog prompt suggestions
Read
Lists the buyer prompts suggested from a store catalog, oldest first, with their status and the product each one came from.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List cited Reddit content
Read
Which Reddit content AI answers cite for your tracked prompts.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List competitor citations
Read
Includes visible citations and background source references.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List competitor mentions
Read
List competitor mentions
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List competitors
Read
List competitors
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List custom AI studies
Read
The custom AI studies defined on the account: analyst reports over any set of subjects (brands, sectors, topics) and any set of dimensions.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List GEO audit alerts
Read
List GEO audit alerts
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List GEO audits
Read
Lists the project's audits, most recently updated first.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List GEO Writer tasks
Read
List GEO Writer tasks
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List local businesses
Read
Local businesses (shops, restaurants, services) listed inside AI answers, one row per business: its name at its address, so two locations of a chain are two rows.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List locales with data
Read
List locales with data
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List models with data
Read
List models with data
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List owned-media citations
Read
Which owned-media content AI answers cite, by platform.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List pending team invitations
Read
Lists invitations that have not been accepted yet: the address, the access and projects the person will get, when the invitation was sent and when its link expires.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List projects
Read
All projects accessible with your API key.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List prompt executions
Read
List prompt executions
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List prompts
Read
List prompts
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List query fan-out
Read
The sub-queries a model actually issued when answering your tracked prompts.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List recommendation runs
Read
List recommendation runs
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List reputation reports
Read
The monthly multi-model analyst reports scoring the tracked brand and its competitors, newest first.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List sentiment categories (Growth plan or above)
Read
Sentiment metric keys + labels + colors.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List sentiment records (Growth plan or above)
Read
Requires the Growth plan; lower tiers receive ERRPLANREQUIRED.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List shopping results
Read
Product cards returned inside AI answers.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List source URLs
Read
List source URLs
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List tags (alias for /collections)
Read
List tags (alias for /collections)
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List tags/collections
Read
List tags/collections
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List team members
Read
Lists the account owner first, then every team member who joined, with their access level (permissionrole, account role and the resulting permissions), co-owner and billing flags, project access,.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List technical GEO reports
Read
Lists reports of one technical GEO type for a project, newest first.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List the findings of a GEO audit run
Read
List the findings of a GEO audit run
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List the issues of a GEO audit
Read
List the issues of a GEO audit
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List the runs of a GEO audit
Read
List the runs of a GEO audit
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
List timeline annotations
Read
Lists project timeline annotations, newest first.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Match a store to a project
Read
Tells a store app whether the API key's account can use it and which project the store belongs to: the live project whose domain equals the store domain, else one whose domain is a parent or a.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Mention share by citing domain
Read
For the responses where each given source domain is cited, returns the share of those responses that mention the brand vs each competitor (brand + competitors sum to 100% per domain).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Per-prompt metrics summary
Read
Paginated per-prompt aggregated metrics.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Position distribution comparison
Read
Position distribution comparison
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Project details
Read
Detailed info for one project: matchingnames, additionalowneddomains, industry, business model, primary products, target audience, brand voice, locale, app store IDs, stats (incl.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Query web analytics
Read
Run a read-only query on the project's connected web analytics (GA4, Adobe, Matomo, PostHog HogQL, Plausible or Piano) in its own format; up to 5,000 rows, cached 10 minutes, spends the provider's quota (Growth plan or above).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Read AI-referred store orders
Read
Reads back the AI-referred orders a store app pushed for a project: totals, one row per AI assistant and a daily series of the days with orders.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Reject catalog prompt suggestions
Write
Marks pending suggestions as rejected; suggestions that are no longer pending stay as they are.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Replace AI-referred store orders for a window
Write
Replaces the daily AI-referred orders and revenue of the from..to window.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Search Console rows by several dimensions (Growth+)
Read
Google Search Console rows grouped by 1 to 3 dimensions (date, country, device, page, query, searchAppearance) over a date range, each row carrying its dimension values as fields plus impressions,.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Search Console summary (Growth+)
Read
Google Search Console headline totals (impressions, clicks, ctr as a 0..1 fraction, average position) for the project over a date range.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Search Console time series (Growth+)
Read
Google Search Console series (impressions, clicks, ctr, position) bucketed by day, week or month, property-wide unless filters narrows it.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Share of Voice
Read
Share of Voice breakdown comparing your project to competitors.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Time-series metrics
Read
Returns time-series data for one or more metrics, broken down by actor (project + competitors).
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Top cited sources
Read
Registrable domains most frequently cited in AI responses for the project, including visible citations and background source references.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Top Search Console pages (Growth+)
Read
Top Google Search Console landing pages over a date range, ranked by impressions, clicks, ctr or position, paginated.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Top Search Console queries (Growth+)
Read
Top Google Search Console search queries over a date range, ranked by impressions, clicks, ctr or position, paginated.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
Update a competitor
Write
Updates brandname, the competitor website domain or host, matchingnames (full replacement list; the brand name is always included automatically), color and/or the citation URL matching rule.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a GEO audit
Write
Updates the schedule, the email alerts or the status.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a project profile (Brand Book)
Write
Updates the project name and profile, the same fields as Project Settings: name, brandname, description, industry, businessmodel (plus businessmodelother when it is OTHER), targetaudience,.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a tag
Write
Renames a tag/collection or changes its description.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a timeline annotation
Write
Updates title, description, annotationdate, color and/or annotationcategoryid.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Web analytics query format (Growth+)
Read
How to query the web analytics provider connected to the project, live: the provider, the property every query runs on, the native query format it accepts, the allowed top-level fields, the rules.
Permissions and limits
Account permissions
An LLM Pulse API key (Scale plan or above; read_write scope for writes)
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in LLM Pulse. A saved workflow is not a completed provider action.
Marketing ยท CONNECTION
