aiseo_list_competitors

List competitor brands already tracked on a project.

Use this before a gap analysis or snippet comparison so you do not invent rival names. Status is TRACKED, SUGGESTED, or IGNORED.

Why you need it

Skills that mention “competitors” still need the list the user actually tracks. Guessing “HubSpot, Salesforce, Pipedrive” is wrong if the project only tracks two of them, or tracks a niche rival instead.

Use it when you need to:

• Pass a real brand into aiseo_list_snippets.
• Scope a gap analysis to tracked rivals, not the open web.
• See which suggested brands the user has not accepted yet.

Capabilities

• List competitor brands with name, slug, domain, aliases, and status.
• Include suggested and ignored rows, not only active tracking.
• Give brandSlug you can pass as brand on snippets.

Parameters

No extra filters. Ignore IGNORED rows in the client if you only want active rivals.

Input

{
  "projectSlug": "acme"
}

Output

{
  "project": {
    "href": "/p/acme/reports",
    "name": "Acme",
    "slug": "acme"
  },
  "competitors": [
    {
      "aliases": ["Hubspot"],
      "brandName": "HubSpot",
      "brandSlug": "hubspot",
      "domain": "hubspot.com",
      "href": "/p/acme/competitors/hubspot",
      "status": "TRACKED"
    },
    {
      "aliases": [],
      "brandName": "Pipedrive",
      "brandSlug": "pipedrive",
      "domain": "pipedrive.com",
      "href": "/p/acme/competitors/pipedrive",
      "status": "SUGGESTED"
    }
  ]
}