Agentic Platform
Documentation API reference Tools Skills

Tools

AI Visibility Campaigns List

ai_visibility_campaigns_list MCP Competitive analysis

List the AI Visibility campaigns configured on the current project.

List the AI Visibility campaigns configured on the current project: name, id, status, platforms, countries, and how prompts are sourced.

Playground

POST
item
include_deleted

When true, include campaigns with status deleted. Defaults to false.

Credits

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
include_deleted boolean

When true, include campaigns with status deleted. Defaults to false.

Default: false

Example
{
  "include_deleted": false
}

Response

object
Properties
campaigns array required

AI Visibility campaigns on the project

Items: AiVisibilityCampaign

count integer required

Number of campaigns returned after filtering

Example
{
  "campaigns": [
    {
      "id": "string",
      "name": "string",
      "campaign_type": "top_gsc_keywords",
      "status": "active",
      "providers": [
        "string"
      ],
      "size": 0,
      "countries": [
        "string"
      ],
      "categories": [
        "string"
      ],
      "intents": [
        "informational"
      ],
      "contains_brand": "all_prompts",
      "created_date": null,
      "modified_date": null
    }
  ],
  "count": 0
}

Type Definitions

1 type

These are the available sub-object types that can be used in the properties above.

AiVisibilityCampaign object
#

One AI Visibility campaign, reduced to the fields a caller needs to pick one.

id string required

Campaign id

name string required

Campaign name

campaign_type string required

How prompts are sourced: top_gsc_keywords (Search Console), categories (one list of topics per country), or csv_import

Values: top_gsc_keywords categories csv_import

status string required

active, inactive, or deleted

Values: active inactive deleted

providers array required

AI platforms the campaign tracks, such as chatgpt, google_gemini, google_ai_overview, google_ai_mode, perplexity

size integer required

Number of prompts the campaign is budgeted to run

countries array required

ISO 3166-1 alpha-3 country codes the campaign runs in

categories array required

Topic names for a categories campaign, in source order. Empty for the other campaign types.

intents array required

Prompt intents the campaign keeps: informational, commercial, transactional, or all. all and an empty list both mean every intent.

Allowed values: informational commercial transactional all

contains_brand string required

Whether prompts must mention the brand: all_prompts, branded_only, or non_branded_only

Values: all_prompts branded_only non_branded_only

created_date string | null

When the campaign was created

Default: null

modified_date string | null

When the campaign was last modified

Default: null

Endpoints

POST http://agents.botify.com/{organization}/{project}/ai_visibility_campaigns_list/process
POST http://agents.botify.com/{organization}/{project}/ai_visibility_campaigns_list/batch_process
POST http://agents.botify.com/{organization}/{project}/ai_visibility_campaigns_list/async_process
POST http://agents.botify.com/{organization}/{project}/ai_visibility_campaigns_list/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/ai_visibility_campaigns_list/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {}
}'

Over MCP

This tool is exposed as the MCP tool ai_visibility_campaigns_list. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata