{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/llmpulse-ai/json-schema/llmpulse-ai-project-details-schema.json",
  "title": "ProjectDetails",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/llmpulse-ai-openapi.json#/components/schemas/ProjectDetails",
  "allOf": [
    {
      "$ref": "#/$defs/Project"
    },
    {
      "type": "object",
      "required": [
        "tracked",
        "untracked_reason"
      ],
      "properties": {
        "url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        },
        "description": {
          "type": [
            "string",
            "null"
          ]
        },
        "matching_names": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "additional_owned_domains": {
          "$ref": "#/$defs/AdditionalOwnedDomains"
        },
        "industry": {
          "description": "Industry as stored: one key as a string (e.g. SAAS), or an array of key strings when the project was created with a list or the in-app multi-select. Deliberately untyped so generated clients decode either shape"
        },
        "business_model": {
          "type": [
            "string",
            "null"
          ]
        },
        "business_model_other": {
          "type": [
            "string",
            "null"
          ],
          "description": "Set only when business_model is OTHER"
        },
        "primary_products": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "target_audience": {
          "type": [
            "string",
            "null"
          ]
        },
        "brand_voice": {
          "type": [
            "string",
            "null"
          ]
        },
        "goals": {
          "type": [
            "string",
            "null"
          ]
        },
        "country_code": {
          "type": "string"
        },
        "language_code": {
          "type": "string"
        },
        "paused": {
          "type": "boolean"
        },
        "google_play_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "app_store_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        },
        "prompt_limit": {
          "type": [
            "integer",
            "null"
          ],
          "description": "The most prompts this project can hold, set by the account owner or a co-owner (Account Settings > Prompt Limits). Null when the project has no limit of its own; the account's plan allowance applies either way"
        },
        "project_type": {
          "type": [
            "string",
            "null"
          ],
          "description": "The project type it is billed as under the account's pricing agreement, such as core or lean (its own, else the account's default type). Null for accounts without per-project types and for pitch projects"
        },
        "stats": {
          "type": "object",
          "properties": {
            "prompts_count": {
              "type": "integer"
            },
            "prompts_by_brand_kind": {
              "type": "object",
              "description": "Prompt counts per brand focus",
              "properties": {
                "brand": {
                  "type": "integer"
                },
                "brand_other": {
                  "type": "integer"
                },
                "non_brand": {
                  "type": "integer"
                }
              }
            },
            "competitors_count": {
              "type": "integer"
            },
            "collections_count": {
              "type": "integer"
            },
            "prompts_available": {
              "type": [
                "integer",
                "null"
              ],
              "description": "How many prompts can still be added to this project now, the same number the Prompts page offers. The lower of the project's free slots under prompt_limit and the account's remaining prompts; 0 when either is full (a project over its limit keeps its prompts). Null when neither caps it"
            }
          }
        },
        "pitch_run": {
          "type": [
            "object",
            "null"
          ],
          "description": "The one run of a pitch project; null for a tracked project. Its answers are dated between launched_at and settled_at, so read its metrics with from set to the launched_at date (the default ranges leave out a pitch older than a few weeks)",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "starting",
                "running",
                "ready"
              ],
              "description": "starting before the run begins, running while answers arrive, ready once every AI model has answered or stopped trying"
            },
            "launched_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            },
            "settled_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            },
            "models": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "chatgpt",
                  "perplexity",
                  "ai_mode",
                  "ai_overview",
                  "gemini",
                  "copilot",
                  "amazon_rufus",
                  "claude",
                  "grok",
                  "deepseek",
                  "naver_ai",
                  "baidu_ai",
                  "meta_ai",
                  "naver_ai_tab",
                  "qwen",
                  "doubao",
                  "bing_ai_mode"
                ]
              },
              "description": "The AI models the run asks, fixed when it starts"
            },
            "answers_expected": {
              "type": "integer"
            },
            "answers_received": {
              "type": "integer"
            }
          }
        },
        "data_coverage": {
          "type": "object",
          "description": "AI models, countries and languages the project has data for",
          "properties": {
            "models": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "chatgpt",
                  "perplexity",
                  "ai_mode",
                  "ai_overview",
                  "gemini",
                  "copilot",
                  "amazon_rufus",
                  "claude",
                  "grok",
                  "deepseek",
                  "naver_ai",
                  "baidu_ai",
                  "meta_ai",
                  "naver_ai_tab",
                  "qwen",
                  "doubao",
                  "bing_ai_mode"
                ]
              }
            },
            "countries": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "languages": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "search_console": {
          "type": "object",
          "description": "Google Search Console connection of the project, judged by its primary property. connected means the Search Console endpoints can answer; reconnect_required means Google refused the primary property's stored access, so reads without property return ERR_SEARCH_CONSOLE_ACCESS_REVOKED until it is reconnected at connect_url, while a property GET /search_console/properties lists as connected, or property=all, still answers; not_connected means the endpoints return ERR_SEARCH_CONSOLE_NOT_CONNECTED.",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "connected",
                "reconnect_required",
                "not_connected"
              ]
            },
            "property": {
              "type": [
                "string",
                "null"
              ],
              "description": "The primary property (e.g. sc-domain:example.com), null when not connected"
            },
            "connect_url": {
              "type": "string",
              "format": "uri",
              "description": "The in-app page where the property is connected or reconnected (Preferences > Project Settings > Connections)"
            },
            "properties_count": {
              "type": "integer",
              "description": "Connected properties Google still accepts (reconnect_required ones excluded); GET /search_console/properties lists every property with its status"
            }
          }
        },
        "ai_traffic": {
          "type": "object",
          "description": "Web analytics provider behind /metrics/ai_traffic and /web_analytics. connected means both answer; reconnect_required means the provider refused the stored access, so /metrics/ai_traffic still answers from synced data and /web_analytics returns ERR_WEB_ANALYTICS_ACCESS_REVOKED until it is reconnected at connect_url; not_connected means they return ERR_AI_TRAFFIC_NOT_CONNECTED and ERR_WEB_ANALYTICS_NOT_CONNECTED.",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "connected",
                "reconnect_required",
                "not_connected"
              ]
            },
            "provider": {
              "type": [
                "string",
                "null"
              ],
              "description": "The connected provider (e.g. google_analytics, adobe_analytics, adobe_cja, posthog, plausible, matomo, piano), null when not connected"
            },
            "connect_url": {
              "type": "string",
              "format": "uri",
              "description": "The in-app AI Traffic page, where the provider is connected or reconnected"
            }
          }
        },
        "agent_traffic": {
          "type": "object",
          "description": "Agent traffic source behind /metrics/agent_traffic. connected and reconnect_required (the source refused the stored access, so syncing stopped) both answer from stored data; imported means no live source is connected but imported logs answer; not_connected means it returns ERR_AGENT_TRAFFIC_NOT_CONNECTED.",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "connected",
                "reconnect_required",
                "imported",
                "not_connected"
              ]
            },
            "provider": {
              "type": [
                "string",
                "null"
              ],
              "description": "The connected source (e.g. cloudflare_graphql, bunny_cdn, s3 or the log drain's provider), null without a live source"
            },
            "connect_url": {
              "type": "string",
              "format": "uri",
              "description": "The in-app Agent Analytics page, where a source is connected or reconnected"
            }
          }
        },
        "request_id": {
          "type": "string"
        }
      }
    }
  ],
  "$defs": {
    "AdditionalOwnedDomains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other domains the brand owns (at most 10, each a website's own domain covering its subdomains), whose citations count as owned like the project website. Empty when none"
    },
    "Project": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string",
          "description": "Internal project label (sidebar, settings, admin)"
        },
        "brand_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "LLM-facing brand label (used in prompts and customer-facing charts). Null when not set, in which case prompts and charts use `name`."
        },
        "tracked": {
          "type": "boolean",
          "description": "Whether scheduled runs include this project. False when it is a pitch project, which runs once, when it is paused, or when the plan's project limit leaves it out (the oldest projects up to the limit run), so its prompts do not run"
        },
        "untracked_reason": {
          "type": [
            "string",
            "null"
          ],
          "description": "Why tracked is false: pitch_project, paused or project_limit. Null when tracked"
        },
        "pitch": {
          "type": "boolean",
          "description": "Whether this is a pitch project, a one-off snapshot that runs its prompts once, takes no project slot and is deleted at pitch_expires_at unless it is converted (PATCH /projects/{id} with pitch false)"
        },
        "pitch_expires_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When a pitch project is deleted, with its data, unless it is converted first. Null for a tracked project"
        }
      }
    }
  }
}