Create a CSV export
argorant_create_exportDestructive
Create a CSV file of the people who match a search, with names, work emails and profile links. Use it when the user wants a spreadsheet of more people than a reveal shows. For a saved list use argorant_export_list, and for a few people in the chat use argorant_reveal_people. Each person with a working email costs 1 credit, and people exported before are skipped unless exclude_previously_exported is false. Phone numbers are only included when include_phones is true. They cost 10 credits per phone number returned, nothing if none is found. Ask the user before spending. Phone numbers need the Pro plan or higher. Tell the user what it can cost and get their approval before you start, because asking again can start a second export. The file is made in the background; follow it with argorant_export_status, or argorant_export_batch_status when a large search is split into several files. A search with exclusions, title or keyword match choices, or the gender, income, range or place filters exports up to 50,000 people at a time; for more, save it with argorant_create_list and export that list. It takes the same filters and defaults as argorant_count_people. More in the docs at https://docs.argorant.com/docs/agents/tools#reveal-enrich-export
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "argorant_create_export"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text for the search, such as "dental clinics" or a person's job and place. A request such as "software companies selling to restaurants" is read as company_category and sells_to. Prefer the dedicated filters when you know them. | |
| city | No | Cities by name. A comma means any of them. | |
| limit | No | Most people to put in the file (default 1,000). | |
| state | No | States or provinces by name or code, such as Texas or TX. A comma means any of them. | |
| title | No | Job titles to find. A comma means any of them. Short forms work both ways, so CFO also finds Chief Financial Officer. | |
| gender | No | Gender, female or male, based on first name and country. Names used for both women and men are left out. Not available for lending audiences. | |
| radius | No | Distance around the place, between 0.5 and 500. | |
| country | No | Countries, or regions such as Europe, EMEA, DACH, Nordics, Benelux, APAC, LATAM, North America or GCC. A comma means any of them. Regions can overlap. Egypt is in both Middle East and Africa, Mexico is in both North America and LATAM, and Turkey counts as Middle East, not Europe. A person is counted once, even when several of the regions you name include their country. | |
| industry | No | Industries by name, such as Software or Hospitals and Health Care. A comma means any of them. | |
| keywords | No | Words that describe what the company does, such as fintech, MSP or freight forwarding. A comma means any of them. They match the company's name, tags, industry and description, not people's own skills, unless you set where keywords look to people or any. | |
| near_lat | No | Latitude of the place to search around. Use it with near_lon and radius. | |
| near_lon | No | Longitude of the place to search around. Use it with near_lat and radius. | |
| sells_to | No | Who the company sells to, used with company_category. One of restaurants, construction, dentists, salons, auto_repair, hotels, logistics, trades, retailers or smb. It finds the companies that sell, never their customers. | |
| geography | No | The same as country. Countries or regions such as Europe, DACH, Nordics or North America. | |
| has_email | No | true (the default) looks only at people with a work email, like every count, preview, export and list. false also includes people without one. | |
| has_phone | No | true keeps only people with a phone number on file. Phone numbers themselves are only shown when paid for. | |
| seniority | No | How senior the person is. Pick one or more. | |
| near_place | No | A place to search around, written out as a city or a postal code, for example Denver, Colorado or 10115 Berlin. Use it with radius. | |
| departments | No | The person's department. Pick one or more. | |
| founded_max | No | Companies founded in this year or earlier, such as 2020. | |
| founded_min | No | Companies founded in this year or later, such as 2015. Companies whose founding year is not known are left out. | |
| radius_unit | No | Unit of the distance, miles (mi, the default) or kilometers (km). | |
| revenue_max | No | Largest yearly revenue in US dollars, such as 50M. | |
| revenue_min | No | Smallest yearly revenue in US dollars, such as 1M. A company counts when its revenue range overlaps yours. | |
| title_match | No | How a job title must match. words (the default) needs every word as a whole word, so Data does not match Database. exact needs the whole title to be one of the values, so CEO does not match Founder & CEO. contains finds the text anywhere, also inside a word, and is slower. | |
| company_name | No | Company names. A comma means any of them. Prefer company_domain when you know the website. | |
| exclude_city | No | Cities to leave out. A comma means any of them. | |
| has_linkedin | No | true keeps only people with a profile link. | |
| revenue_band | No | Yearly company revenue in US dollars, as bands. Pick one or more. | |
| technologies | No | Technologies the company uses, such as Shopify, HubSpot or AWS. A comma means any of them. | |
| country_match | No | Whose place a country means. person (the default) counts people by where they are based and leaves out people whose own place is not known. person_or_company also counts them by their company's country. | |
| employees_max | No | Largest number of employees, such as 500. | |
| employees_min | No | Smallest number of employees, such as 50. A company counts when its size range overlaps yours. | |
| exclude_state | No | States or provinces to leave out. A comma means any of them. | |
| exclude_title | No | Job titles to leave out, matched the same way as title. A comma means any of them. | |
| keyword_scope | No | Where keywords look. company (the default) looks only at what the company does: its name, tags, industry and description, so a search for MSP finds people at managed service providers. Use people only when the user wants people who have a skill themselves, such as people who know Python or Salesforce admins at any company; it looks only at the person's own skills and profile. any looks at both, plus job titles. Without a value, company is used. | |
| radius_target | No | Whose location counts. any (the default) is where the person is based, or where their company is when their own place is not known. person is only where the person is based, company only where their company is based. | |
| verified_only | No | Deprecated. It has no effect on the search and will be removed. Leave it out. | |
| company_domain | No | Company website domains, such as stripe.com. A comma means any of them. | |
| employee_range | No | Number of employees at the company: size bands (pick one or more), or one text value with a range like "1-500". | |
| include_phones | No | true also looks up phone numbers, at the phone price in the description. Off by default. | |
| industry_match | No | How industries match. any (the default) finds the industry anywhere in what the company is tagged with. primary only counts the company's main industry, so Software and Internet leaves out a retailer or a bank that also carries a software tag. | |
| company_country | No | Countries or regions where the company has its head office, with the same names as country. Use it with country to get people in a country at companies based there. For people it works together with a list of company websites (company_domain) for now. | |
| email_when_done | No | true emails the user when the file is ready. | |
| exclude_country | No | Countries or regions to leave out, matched the same way as country. A comma means any of them. | |
| company_category | No | What kind of company sells, used with sells_to. One of software, payments, pos_payments, business_fintech, accounting_software, payroll_hr_software, formation, association, marketplace or investors. | |
| exclude_industry | No | Industries to leave out, matched the same way as industry. A comma means any of them. | |
| exclude_keywords | No | Words to leave out, matched the same way as keywords. A comma means any of them. | |
| exclude_seniority | No | Seniority levels to leave out. Pick one or more. | |
| exclude_assistants | No | On by default. A job title search leaves out assistant titles such as assistant to, executive assistant or personal assistant. Set it to false to keep them. The answer lists what it left out under applied_defaults, and a saved list keeps the setting. | |
| business_email_only | No | Only people whose email is at their company's own domain. Off unless you set it, so private addresses are left out only on request. When it is on, the answer says so under applied_filters. | |
| exclude_departments | No | Departments to leave out. Pick one or more. | |
| exclude_title_match | No | How the titles to leave out must match, with the same choices. When it is not set, the title choice is used. | |
| exclude_company_domain | No | Company website domains to leave out. A comma means any of them. | |
| exclude_previously_exported | No | true (the default) skips people this account exported before. false puts them in the file again. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |