Temso

Deprecated: use create-offerings, update-offerings or delete-offerings instead. Create / update / delete offerings (products/services) in one batch.

bulk-apply-offerings

Deprecated: use create-personas, update-personas or delete-personas instead. Create / update / delete personas in one batch.

bulk-apply-personas

Deprecated: use create-prompt-tags, update-prompt-tags or delete-prompt-tags instead. Create / update / delete prompt tags in one batch.

bulk-apply-prompt-tags

Deprecated: use create-prompts, update-prompts or archive-prompts instead. Create / update / archive prompts in one batch.

bulk-apply-prompts

Archive one or more prompts by ID. Each item is applied on its own, and the result lists the outcome for each item.

archive-prompts

List domains that link to the tracked competitors but not to this project — link-building prospects, sorted by how many competitors they link to. gapCompetitorsUsed < gapCompetitorsTotal means the gap covers only a subset of competitors.

fetch-backlink-gap

Fetch the backlink profile history: one snapshot per sync with rank, backlinks, referring domains, AI-cited domains and new/lost counts.

fetch-backlink-timeseries

Fetch the project's backlink profile summary: sync status (last sync, cooldown, warnings) plus KPIs — domain rank, backlinks, referring domains, AI-cited domains, and new/lost counts. neverSynced: true means no completed sync has produced data yet — check sync.status and sync.lastError, a first sync may have failed.

fetch-backlink-overview

List individual backlinks (referring page → target URL) with anchor, referring-domain rank, spam score (0-100, higher = spammier), dofollow flag and the AI signal on the referring domain. totalMatchingFilters counts the rows matching the filters you passed, not the whole profile. appearedAsAiSource includes the citedInAiAnswers rows — it is the wider signal, not the uncited remainder.

fetch-backlinks

Fetch the details of the brand the project tracks. In a pitch project, this is the prospect.

fetch-brand-details

Fetch brand perception analytics showing how brands are described (e.g., reliable, innovative, affordable).

fetch-brand-perception

Fetch AI visibility brand rankings within a time range.

fetch-brand-rankings

Fetch campaigns for the current project with optional status filter.

fetch-campaigns

Fetch cited pages / source URLs with citation analytics. Alias of fetch-source-urls for the Sources UI table. brandMentions covers only the returned page of URLs (null = not yet scanned).

fetch-cited-pages

Fetch source URLs / cited pages with citation analytics within a time range. Returns title, domain, URL, appearances, models, cited percentage, and last seen. brandMentions covers only the returned page of URLs (null = not yet scanned) — to check whether a domain mentions a brand, use fetch-top-domains.

fetch-source-urls

Fetch tracked competitors.

fetch-competitors

List content gap analysis runs for the project, newest first. A depthScore is the maximum coverage score of the single best-matching page for a prompt, not a sum; 0 means no page on the site answers it. pageCount is the pages that reached the analysis and crawledPageCount everything the crawl captured; they differ by the blocked pages plus every page too thin to analyse, so never read the difference as pages lost to bot protection — blockedPageCount is that number. If crawlWarning is present, relay it to the customer and treat the findings as incomplete; if note is present, relay it to the customer.

fetch-content-gap-runs

Fetch content-gap detail for one prompt, including the 15 best-matching pages. Defaults to the newest completed run that includes gap analysis; pass runId to target another run. A depthScore is the maximum coverage score of the single best-matching page for a prompt, not a sum; 0 means no page on the site answers it. If note is present, relay it to the customer and treat the findings as incomplete.

fetch-content-gap-detail

Fetch a compact content-gap summary for one analysis run, grouped only by depthScore coverage bands and limited to the 15 worst prompts. Defaults to the newest completed run that includes gap analysis; pass runId to target another run. A depthScore is the maximum coverage score of the single best-matching page for a prompt, not a sum; 0 means no page on the site answers it. If crawlWarning is present, relay it to the customer and treat the findings as incomplete; if note is present, relay it to the customer.

fetch-content-gaps

Get one content piece's header and per-step status (label, kind, human-input policy, revision, quality/brandkit/factcheck outcomes, size). Metadata only — no step bodies. Use read-content-piece-step to read a step's output.

fetch-content-piece

Read one content-piece step's output, rendered to markdown (doc/markdown steps) or pretty JSON (json steps) and length-capped. Get the step id from fetch-content-piece. Image steps have no readable artifact. To publish an article, use fetch-publishable-article instead: it returns the full body and its metadata.

read-content-piece-step

List content pieces as compact one-line summaries (id, status, title, format, current step). Start here, then fetch-content-piece for one piece's steps, then read-content-piece-step to read a step's output. Statuses: created (brief only, not generated), processing (generating now), waiting_for_input (paused for your approval or an answer), revising (regenerating after edits), ready (all steps generated), published, failed, archived.

fetch-content-pieces

Create one or more tracked competitors. Each item is applied on its own, and the result lists the outcome for each item.

create-competitors

Create one or more offerings (products/services). Each item is applied on its own, and the result lists the outcome for each item.

create-offerings

Create one or more personas. Each item is applied on its own, and the result lists the outcome for each item.

create-personas

Create one or more prompt tags. Each item is applied on its own, and the result lists the outcome for each item.

create-prompt-tags

Create one or more prompts. Each item is applied on its own, and the result lists the outcome for each item.

create-prompts

Delete one or more tracked competitors by ID. Each item is applied on its own, and the result lists the outcome for each item.

delete-competitors

Delete one or more offerings (products/services) by ID. Each item is applied on its own, and the result lists the outcome for each item.

delete-offerings

Delete one or more personas by ID. Each item is applied on its own, and the result lists the outcome for each item.

delete-personas

Delete one or more prompt tags by ID. Each item is applied on its own, and the result lists the outcome for each item.

delete-prompt-tags

Potential keyword cannibalization: keywords for which two or more of the site's pages rank, with the number of competing pages and the keyword's clicks and impressions. Web search only; no country or device filter.

fetch-search-cannibalization

List the projects this API key can access. Call this first when you don't know the project ID to pass to other tools. Type "project" is a brand tracked daily. Type "pitch" is a one-time AI visibility snapshot an agency built to win a prospective client; see fetch-pitch-snapshot. A project with "available": false is not included in the account's current plan: its data is not available until the plan is upgraded.

list-projects

Mark a content piece as published in Temso after you published it on the user's site yourself (e.g. in Shopify), and record its live URL. Temso then tracks the page and stops asking the user to publish it by hand. Call it only once the article is live — not for drafts or posts scheduled for later. Only article pieces with status ready or published qualify.

mark-content-piece-published

Fetch monitoring settings (frequency and tracked AI models).

fetch-monitor-settings

Fetch configured offerings/products.

fetch-offerings

Organic search clicks, impressions, CTR and position broken down by country (lowercase ISO 3166-1 alpha-3 codes) or by device. Google Search Console web search only; no country or device filter on top.

fetch-search-breakdown

Top organic search keywords (queries) from Google Search Console or Bing Webmaster Tools, ordered by impressions, with clicks, CTR and average position for the date range. Raise limit before ranking keywords by clicks.

fetch-search-keywords

Organic search winners and losers versus the previous window of equal length: the top 10 keywords or pages that gained clicks, declined, are new (impressions for the first time), or were lost (no impressions any more), plus the total count per bucket.

fetch-search-movements

Top pages in organic search from Google Search Console or Bing Webmaster Tools, ordered by impressions, with clicks, CTR, average position and the page title when known, for the date range. Raise limit before ranking pages by clicks.

fetch-search-pages