> ## 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.

# List buyer titles

> The job titles of the people you sell to

Returns every [buyer title](https://docs.clustr-ai.com/buyer-titles.md), oldest first. When the list is not
empty, anyone whose job title matches none of them is hidden everywhere in Clustr.

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

```json 200 theme={null}
{
  "success": true,
  "data": {
    "keywords": [
      {
        "clustr_keyword_id": "kw_6xzgkggzx1gne7qbxbz5ph658q",
        "id": 41,
        "keyword": "CFO"
      },
      {
        "clustr_keyword_id": "kw_d69pbmkm13axteg0b2b0mnh33b",
        "id": 42,
        "keyword": "Head of Finance"
      }
    ],
    "count": 2
  }
}
```


## OpenAPI

````yaml GET /buyer-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:
  /buyer-titles:
    get:
      tags:
        - Buyer Titles
      summary: List buyer titles
      description: >
        The job titles of the people you sell to: the Buyer titles list on the

        Targeting page. When the list has titles, Clustr shows only people whose

        job title matches one of them, and imports bring in only people who
        match.
      operationId: listBuyerTitles
      responses:
        '200':
          description: Every buyer title, oldest first
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      keywords:
                        type: array
                        items:
                          $ref: '#/components/schemas/JobTitle'
                      count:
                        type: integer
                        example: 2
        '401':
          description: Invalid or missing API key
components:
  schemas:
    JobTitle:
      type: object
      properties:
        clustr_keyword_id:
          type: string
          description: >-
            The buyer title's Clustr ID, for example
            `kw_d69pbmkm13axteg0b2b0mnh33b`, when you list buyer

            titles. Use it to delete the title.
          example: kw_d69pbmkm13axteg0b2b0mnh33b
        clustr_keyword_exclude_id:
          type: string
          description: >-
            The excluded title's Clustr ID, for example
            `kwx_b1m6sfvhv8kmtkb2qj0me7ynaq`, when you list

            excluded titles. Use it to delete the title.
          example: kwx_b1m6sfvhv8kmtkb2qj0me7ynaq
        id:
          type: integer
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustr_keyword_id` or `clustr_keyword_exclude_id`.
          example: 42
        keyword:
          type: string
          description: The title text
          example: Head of Finance
  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.