> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Competitor Team Titles

> The job titles the competitor team search looks for

The job titles Clustr searches for when it finds a competitor's Sales and CS people. Each title
has a `function` (`sales`, `cs` or `other`), which becomes the Function column of the people it
finds, and `enabled`: only enabled titles are searched.

Until you change it, your workspace uses the default list (`is_default: true`): Sales and CS
titles are on, and executive, founder and customer-facing titles (solutions, partner,
implementation) are listed but off. Change the list with
[Set Competitor Team Titles](https://docs.clustr-ai.com/api-reference/set-competitor-team-titles.md), and go back to the
defaults with [Reset Competitor Team Titles](https://docs.clustr-ai.com/api-reference/reset-competitor-team-titles.md).

`group` says where a default title comes from (`sales`, `cs`, `exec`, `founder`,
`customer_facing`), or `custom` for a title you added. It is read only.

```bash cURL theme={null}
curl https://api.clustr-ai.com/api/public/competitor-team-titles \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python Python theme={null}
import requests

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-team-titles",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
```

```javascript JavaScript theme={null}
await fetch("https://api.clustr-ai.com/api/public/competitor-team-titles", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "titles": [
      { "title": "account executive", "function": "sales", "group": "sales", "enabled": true },
      { "title": "customer success manager", "function": "cs", "group": "cs", "enabled": true },
      { "title": "vp sales", "function": "sales", "group": "exec", "enabled": false },
      { "title": "founder", "function": "other", "group": "founder", "enabled": false }
    ],
    "is_default": true
  }
}
```


## OpenAPI

````yaml GET /competitor-team-titles
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /competitor-team-titles:
    get:
      tags:
        - Competitor Monitoring
      summary: Get Competitor Team Titles
      description: >
        The job titles the competitor team search looks for, each with its
        function and

        whether it is enabled.
      operationId: getCompetitorTeamTitles
      responses:
        '200':
          description: The title list
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/CompetitorTeamTitles'
        '401':
          description: Invalid or missing API key
components:
  schemas:
    CompetitorTeamTitles:
      type: object
      properties:
        titles:
          type: array
          items:
            $ref: '#/components/schemas/CompetitorTeamTitle'
        is_default:
          type: boolean
          description: True while the workspace uses the default list.
    CompetitorTeamTitle:
      type: object
      properties:
        title:
          type: string
          example: account executive
        function:
          type: string
          enum:
            - sales
            - cs
            - other
        group:
          type: string
          enum:
            - sales
            - cs
            - exec
            - founder
            - customer_facing
            - custom
          description: >-
            The role group the title belongs to, which title_groups on a
            competitor selects; `custom` for a title you added.
        enabled:
          type: boolean
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.