SE Ranking

Project Tool: Add a new task to the marketing plan for a website.

PROJECT_addPlanTask

Project Tool: Add a single backlink to the backlink monitor for a website. Returns `{ id: <backlink_id> }` — the dictionary-level `backlink_id` (accepted by `deleteProjectBacklinks`). IMPORTANT: `moveBacklinksToGroup` and `recheckProjectBacklinks` do NOT accept this value — they require the row-level `id` field from `listProjectBacklinks` (passing this returned backlink_id to moveBacklinksToGroup is a silent no-op; to recheck it errors "Backlinks are non exists").

PROJECT_addProjectBacklink

Project Tool: Add new prompts (keywords) to a specific LLM engine in AI Result Tracker. Duplicates are automatically skipped.

PROJECT_addPrompts

SE Visible Tool: Add one or more aliases to an existing brand (works for both the primary brand and competitors). Each alias title must be unique within the project and not match any existing brand or alias. To replace/clear the whole alias set instead, use SEV_updateBrand.

SEV_addBrandAliases

SE Visible Tool: Add a competitor brand to a project, with a domain and optional aliases. Brands created here are always competitors (is_primary: false); the primary brand is set at project creation. The title must be unique within the project.

SEV_createBrand

SE Visible Tool: Attach one AI engine to a project and run the project's prompts against it. The call fails when the engine is already tracked. Re-adding an engine removed earlier restores it together with the results, mentions and sources collected before the removal. To set the whole engine list at once use SEV_syncProjectEngines.

SEV_addProjectEngine

Project Tool: Add a Google search engine to a project for rank tracking. Country targeting takes EXACTLY ONE of: (a) `country_code` — ISO 3166-1 alpha-2 (e.g. "us", "de", "fr"); the server resolves it to the right `search_engine_id`. (b) `search_engine_id` — direct numeric ID for callers who already have it (look up via PROJECT_getAvailableSearchEngines, e.g. 200 = Google USA). Returns `site_engine_id`, the project-local ID used by every other rank-tracking tool (`runPositionCheck`, `getPositionHistory`, `getKeywordStats`, etc.).

PROJECT_addSearchEngine

Project Tool: Requires a project ID. Add a tag to the site and attach it to a link and/or domain.

PROJECT_addTag

Data Tool: Retrieves a list of anchor texts for backlinks pointing to the specified target, with sorting and limit options.

DATA_getBacklinksAnchors

Data Tool: Returns authority metrics — InLink Rank (page authority) and Domain InLink Rank — for a target domain, host, or URL.

DATA_getBacklinksAuthority

Data Tool: Returns backlink-profile fields for one or many targets — counts plus authority (InLink Rank, Domain InLink Rank), home-page link counts, text-link totals, and referring-domain breakdowns. Use for an at-a-glance profile; for only the core counts, use getBacklinksMetrics. Supports batch requests.

DATA_getBacklinksSummary

Data Tool: Returns all backlinks pointing to a target in large pages (up to 100,000 per page) via a `next` cursor, with no filtering. Use to pull an entire backlink set in batches; for a filtered or sorted slice, use getAllBacklinks.

DATA_getBacklinksRaw

Data Tool: Returns a filtered, sortable list of backlinks pointing to a target (up to 10,000). Each entry includes url_from, url_to, anchor, nofollow, and inlink_rank. Filter by inlink_rank, domain_inlink_rank, source/target URL, anchor text, and nofollow status; sort via order_by. Use when you want a specific slice of backlinks; to pull an entire backlink set in large batches, use getBacklinksRaw.

DATA_getAllBacklinks

Project Tool: Reorder an AI Result Tracker prompt group relative to another. Specify exactly one of before_id or after_id.

PROJECT_changePromptGroupOrder

Data Tool: Launches an advanced website audit that renders JavaScript before analyzing the page. Suitable for Single-Page Applications (SPAs) or dynamic content. For static or server-side-rendered sites, prefer createStandardAudit (cheaper, faster).

DATA_createAdvancedAudit

Project Tool: Launches a website audit that crawls the HTML of a website. Be aware of the page crawl limit included in your plan.

PROJECT_createAudit

Project Tool: Create a new group for organizing backlinks.

PROJECT_createBacklinkGroup

Project Tool: Requires a project ID. Add a group for project keywords.

PROJECT_createKeywordGroup

Project Tool: Add a new LLM engine to a site in AI Result Tracker. Site must have a brand configured first.

PROJECT_createLlmEngine

Project Tool: Create a new project (a "site" in SE Ranking terminology) on the authenticated account. Returns `{ site_id }` — pass that ID to every other project-scoped tool (`addSearchEngine`, `listKeywords`, audits, etc.). The URL must be a real, resolvable domain; reserved test domains like `*.example.com` are rejected with HTTP 400 "Incorrect website URL". To track-but-not-poll a project (e.g. for tests), pair `is_active: "0"` with `check_freq: "manual"` and `disable_audit: "1"`.

PROJECT_createProject

Project Tool: Create a new project group — an account-level folder that organizes projects — on the authenticated account. Pass a group name; returns the new group ID, which you can pass as site_group_id when creating or updating a project. No project ID is required.

PROJECT_createProjectGroup

Project Tool: Create a new AI Result Tracker prompt group for a site. Returns 400 if a group with the same name already exists.

PROJECT_createPromptGroup

SE Visible Tool: Create a project that tracks a brand's visibility across AI assistants. Processing is asynchronous: the response returns the new project UUID immediately, before any results are ready — poll SEV_getProject until project.status is "success" and check.processed_percent is 100.

SEV_createProject

SE Visible Tool: Create one or more prompts under a topic. The prompts are added to the given topic and start being processed against the project's AI engines. Returns the created prompt IDs. Each prompt costs one prompt unit — neither its language nor the engines the project tracks multiply the charge — so 3 prompts consume 3 of the plan's prompt allowance; when they do not fit the call is refused whole with 403 insufficient_limit and nothing is created — check the headroom with SEV_getSubscription (limits.prompts.available) before a large batch.

SEV_createPrompts

SE Visible Tool: Create one or more topics in a project. Topics group related prompts so you can organise what you track and slice metrics by theme. Returns the created topics. (There is no separate list-topics call — read topics via SEV_getProject.)

SEV_createTopics

Data Tool: Launches a standard website audit that crawls the HTML of a website. Suitable for most static and server-side rendered sites. For JavaScript-rendered sites (SPAs), use createAdvancedAudit instead.

DATA_createStandardAudit

Project Tool: Create a new sub-account and send a notification email to the created sub-account.

PROJECT_createSubAccount

Project Tool: Remove all prompts (keyword rows) linked to an AI Result Tracker prompt group.

PROJECT_deleteAllPromptsInGroup

Data Tool: Permanently deletes a specified website audit report and all of its associated data.

DATA_deleteAudit

Project Tool: Permanently deletes a website audit report and all associated data. This action cannot be undone.

PROJECT_deleteAudit

Project Tool: Removes a sitemap from an audit's crawl sources. Does not toggle source_sitemap off — leave that to updateAuditSettings if you want to disable sitemap crawling entirely.

PROJECT_deleteAuditSitemap

Project Tool: Removes an uploaded source-pages list from an audit. Does not toggle source_file off — leave that to updateAuditSettings if you want to disable custom-list crawling entirely.

PROJECT_deleteAuditSourcePages

Project Tool: Delete a backlink group.

PROJECT_deleteBacklinkGroup

Project Tool: Requires a competitor ID. Remove a competitor website from a user project.

PROJECT_deleteCompetitor

Project Tool: Remove a backlink from the disavowed backlinks list.

PROJECT_deleteDisavowedBacklink

Project Tool: Delete a project keyword group, identified by its group ID (from listKeywordGroups). Takes only group_id; no project ID is required.

PROJECT_deleteKeywordGroup

Project Tool: Requires a project ID. Delete one or more keywords from a project in a single request.

PROJECT_deleteKeywords

Project Tool: Remove an LLM engine from a site in AI Result Tracker.

PROJECT_deleteLlmEngine

Project Tool: Delete a task from the marketing plan. Only tasks created via the API can be deleted.

PROJECT_deletePlanTask

Project Tool: Requires a project ID. Delete a project from the user account.

PROJECT_deleteProject