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

# Buyer titles and excluded titles

> The two job-title lists that decide who Clustr shows you

Two lists on the **Targeting** page decide which people Clustr shows you, by job
title.

| List | What it does |
| - | - |
| **Buyer titles** | The job titles of the people you sell to, such as `CFO` or `Head of Finance`. When the list is not empty, anyone whose job title matches none of them is hidden. |
| **Excluded titles** | Job titles you never want to see, such as `Recruiter` or `Intern`. Anyone whose job title or LinkedIn headline matches one is hidden, even when they also match a buyer title. |

An empty buyer-title list hides nobody. Each list holds up to 1,000 titles.

## How a title matches

A title matches when its words appear in the job title, side by side or in the same
order with other words between them. A match never starts in the middle of a word.

**Excluded titles match whole words only**, so they never hide someone by accident:

| Excluded title | Hides | Does not hide |
| - | - | - |
| `Sales` | Head of Sales, Point of Sale Manager | Salesforce Admin, Presales Engineer |
| `Media` | Head of Media | Head of Banking Intermediaries |
| `Intern` | Summer Intern, Interns Program Lead | International Payments, Internal Audit |

**Buyer titles** also let their last word be the start of a longer word, so a list
written as `Sales Lead` or `Cyber` keeps finding people:

| Buyer title | Shows | Does not show |
| - | - | - |
| `Sales Lead` | Sales Lead, Senior Sales Leader | Lead, Sales |
| `Cyber` | Cyber Analyst, Cybersecurity Manager | Head of IT |
| `Director of Marketing` | Director, Global Marketing | Marketing Director |
| `VP Product` | VP Product, SVP Product, EVP Product | Vice President, Product |

* Capitals, accents and punctuation do not matter: `AML` matches "BSA/AML Officer".
* Singular and plural are the same word: `Partner` matches "Partners".
* Co-roles, feminine forms and compound titles count: `Founder` matches
  "Cofounder", `Président` matches "Présidente", `Leiter` matches "Vertriebsleiter".
* To match the start of a word in an excluded title, end it with `*`: `recruit*`
  hides "Recruiter", "Recruiting" and "Recruitment".
* Buyer titles also accept a one-letter typo, such as "Marketinh". Excluded titles
  never do.

## When a change applies

A change applies to everyone already in your workspace within seconds. You do not
need to run an import again.

Nothing is deleted. A person hidden by a title comes back as soon as you remove
that title.

The lists also decide who your next ingestion runs bring in. Adding a buyer title
today shows the matching people you already have, but it cannot show someone no
run ever brought in.

## From the API

With an [API key](https://docs.clustr-ai.com/authentication.md):

| | Buyer titles | Excluded titles |
| - | - | - |
| List | [`GET /buyer-titles`](https://docs.clustr-ai.com/api-reference/list-buyer-titles) | [`GET /excluded-titles`](https://docs.clustr-ai.com/api-reference/list-excluded-titles) |
| Add | [`POST /buyer-titles`](https://docs.clustr-ai.com/api-reference/add-buyer-titles) | [`POST /excluded-titles`](https://docs.clustr-ai.com/api-reference/add-excluded-titles) |
| Delete | [`DELETE /buyer-titles/{id}`](https://docs.clustr-ai.com/api-reference/delete-buyer-title) | [`DELETE /excluded-titles/{id}`](https://docs.clustr-ai.com/api-reference/delete-excluded-title) |

Adding takes a `keywords` array, and a title already on the list is skipped:

```bash theme={null}
curl -X POST https://api.clustr-ai.com/api/public/buyer-titles \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["CFO", "Head of Finance"]}'
```

## From your AI assistant

The [MCP server](https://docs.clustr-ai.com/mcp-server.md) has the same six operations:

| Tool | What it does |
| - | - |
| `list_buyer_titles` | List your buyer titles, with their ids |
| `add_buyer_titles` | Add buyer titles |
| `delete_buyer_title` | Remove one buyer title |
| `list_excluded_titles` | List your excluded titles, with their ids |
| `add_excluded_titles` | Add excluded titles |
| `delete_excluded_title` | Remove one excluded title |

Ask, for example, "Add CFO and Head of Finance to our buyer titles" or "Stop
showing me recruiters".


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