preview_lead_sample
Preview matching leads
Read · mcp30 calls / 10 minCalls a providerShows up to 10 real people a target returns — name, job title, company, location, LinkedIn — without their email addresses. Free, nobody is imported.
Show up to 10 real people a target returns — name, job title, company, location, LinkedIn — without importing anyone and without spending anything. Previews never include email addresses. Same filters and vocabulary as estimate_lead_pool.Example
Section titled “Example”The user says
Show me a few of them.
{ "name": "preview_lead_sample", "arguments": { "countries": ["FR"], "jobTitles": ["Chirurgien-dentiste"], "subIndustries": ["Medical Practice"], "headcountMin": 2, "headcountMax": 50 }}Arguments
Section titled “Arguments”countriesenum[]optionalone of 249 values≤ 20 itemsWhole countries to search, as ISO 3166-1 alpha-2 codes (FR, DE, US…). Each code covers the entire country. When the founder named a city or a region, it goes in places and its country stays out of this list, unless the instruction you were given asks for their countries and no places: then send the countries alone, and your deliverable says the search left out the place they named.
placesobject[]optional≤ 20 itemsCities or regions (state, province…) the founder named, one object per place: [{"city": "Las Vegas", "region": "Nevada", "country": "US"}]. Give a city, a region or both, never neither. country is always the ISO 3166-1 alpha-2 code: work it out yourself when the founder only named the city. Write the names in full and in English, as on a map. Several places read as one OR the other.
citystringoptional1–80 charsregionstringoptional1–80 charscountrystringrequired2–2 chars
excludedPlacesobject[]optional≤ 20 itemsCities or regions to keep OUT of the search, in the same form as places. It only cuts a place out of a wider one, so it never comes alone: France except Paris is countries ["FR"] with excludedPlaces [{"city": "Paris", "country": "FR"}], and that country stays in countries. It leaves out the address locationScope names: under COMPANY, people who work in that city for a company registered elsewhere still come back, so to keep out the people there, as for a local practice or shop, use CONTACT. Even then a city left out is approximate, some people listed in it still come back, while a region left out holds: never promise the founder that no one from that city remains, and never swap the city for its region without their say.
citystringoptional1–80 charsregionstringoptional1–80 charscountrystringrequired2–2 chars
locationScope"CONTACT" | "COMPANY"optionalWhose address countries, places and excludedPlaces filter on: CONTACT for where the person themselves is, which is what prospects in a city means; COMPANY for where the company is registered, whose people may live elsewhere. It narrows nothing on its own and is ignored when no country and no place is given.
departmentsenum[]optionalone of 9 values≤ 20 itemsDepartments the champion works in.
ENGINEERINGFINANCE_AND_ADMINISTRATIONHUMAN_RESOURCESIT_AND_ISMARKETINGOPERATIONSSALESSUPPORTOTHER
seniorityLevelsenum[]optionalone of 13 values≤ 20 itemsHow senior the champion is.
jobTitlesstring[]optional1–80 chars≤ 20 itemsJob titles the champion holds, whenever the founder names a role (Head of Sales, dentiste, CFO…), written the way people of that market write it on their profile. A title matches every job title that contains it, and several titles read as one OR the other. A title nobody holds comes back as zero leads without any error: that zero is not an empty market, reword the title.
excludedJobTitlesstring[]optional1–80 chars≤ 20 itemsJob titles to keep OUT of the query, matched the same way: anyone whose job title contains one of them is left out, e.g. Intern or Assistant.
includedIndustriesenum[]optionalone of 20 values≤ 20 itemsIndustries to keep IN the query — everything else is left out.
excludedIndustriesenum[]optionalone of 20 values≤ 20 itemsIndustries to keep OUT of the query.
subIndustriesenum[]optionalone of 147 values≤ 20 itemsSub-industries to keep IN the query, for a niche narrower than an industry: Medical Practice rather than all of healthcare. Send them in place of includedIndustries, never with it: the provider adds a sub-industry to a whole industry instead of narrowing it, so both together search wider than either. Several sub-industries read as one OR the other.
excludedSubIndustriesenum[]optionalone of 147 values≤ 20 itemsSub-industries to keep OUT of the query.
revenueBandsenum[]optionalone of 8 values≤ 20 itemsYearly revenue brackets of the target companies, in US dollars. Several brackets read as one OR the other.
UP_TO_1MFROM_1M_TO_10MFROM_10M_TO_50MFROM_50M_TO_100MFROM_100M_TO_250MFROM_250M_TO_500MFROM_500M_TO_1BABOVE_1B
headcountBandsenum[]optionalone of 8 values≤ 20 itemsEmployee-count brackets of the target companies. headcountMin and headcountMax say the same with numbers of your own: use them instead, never both.
UP_TO_25FROM_25_TO_100FROM_100_TO_250FROM_250_TO_1000FROM_1K_TO_10KFROM_10K_TO_50KFROM_50K_TO_100KABOVE_100K
headcountMinintegeroptional≥ 1The fewest employees a target company may have, as a whole number, 1 or more: 500 for at least 500 employees. Use headcountMin and headcountMax in place of headcountBands, never both: given together, the brackets are refused and the numbers kept.
headcountMaxintegeroptional≥ 1The most employees a target company may have, as a whole number, 1 or more: 10 for up to 10 employees. Give it alone or with headcountMin, 11 and 50 for 11 to 50 employees.
technologiesstring[]optional1–80 chars≤ 20 itemsSoftware the target companies use, by product name (HubSpot, Shopify…), when the founder names a tool their buyers run. Several read as one OR the other. A name the provider does not know comes back as zero leads without any error: that zero is not an empty market.
companyWebsitesstring[]optional1–80 chars≤ 20 itemsWebsites of the very companies to search, as bare domains (acme.com: no https://, no path), only when the founder names those companies: nobody else comes back. A domain the provider does not hold comes back as zero leads without any error.
lookAlikeWebsitestringoptional1–80 charsThe website of ONE company the founder holds up as the model of their target, as a bare domain (alan.com): the query returns companies like it. Leave it out when they named no such company.
fundingStagesenum[]optionalone of 17 values≤ 20 itemsFunding rounds the target companies have raised. A company that never raised matches none of these, so a stage filter silently drops bootstrapped markets.
companyEventsenum[]optionalone of 24 values≤ 20 itemsRecent company news to require, e.g. HIRES or RECEIVES_FINANCING. The provider gives no date for these, so never tell the founder how recent they are.
keywordsstring[]optional1–80 chars≤ 20 itemsWords the target COMPANY is found by, in its name or in the description of what it does, never in the person's job title: ["orthodontie"] finds orthodontic practices. Several read as one OR the other, so give each word its own item, in every language those companies describe themselves in: ["dentaire", "dental"]. Words written together in one item are searched as that exact phrase: "dentaire dental" is one rare phrase, not two words. A word no company is described by comes back as 0 without any error: that zero says nothing about their market, so try another word before concluding.
excludedKeywordsstring[]optional1–80 chars≤ 20 itemsWords that keep a company OUT when its name or its description holds one of them. Same form as keywords: one word or exact phrase per item.
hiringForstring[]optional1–80 chars≤ 20 itemsJobs the target companies are hiring for right now, written as their job postings title them: ["Sales Development Representative"]. A company that recruits for a role is growing, and this filters on its open positions, never on the job title of the person contacted. Several read as one OR the other. The provider files most postings under their English title, even outside English-speaking countries: give the English title, with the local one beside it, ["Dental Assistant", "Assistant dentaire"].
Input schema
{ "type": "object", "properties": { "countries": { "description": "Whole countries to search, as ISO 3166-1 alpha-2 codes (FR, DE, US…). Each code covers the entire country. When the founder named a city or a region, it goes in places and its country stays out of this list, unless the instruction you were given asks for their countries and no places: then send the countries alone, and your deliverable says the search left out the place they named.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW" ] } }, "places": { "description": "Cities or regions (state, province…) the founder named, one object per place: [{\"city\": \"Las Vegas\", \"region\": \"Nevada\", \"country\": \"US\"}]. Give a city, a region or both, never neither. country is always the ISO 3166-1 alpha-2 code: work it out yourself when the founder only named the city. Write the names in full and in English, as on a map. Several places read as one OR the other.", "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string", "minLength": 1, "maxLength": 80 }, "region": { "type": "string", "minLength": 1, "maxLength": 80 }, "country": { "type": "string", "minLength": 2, "maxLength": 2 } }, "required": ["country"] } }, "excludedPlaces": { "description": "Cities or regions to keep OUT of the search, in the same form as places. It only cuts a place out of a wider one, so it never comes alone: France except Paris is countries [\"FR\"] with excludedPlaces [{\"city\": \"Paris\", \"country\": \"FR\"}], and that country stays in countries. It leaves out the address locationScope names: under COMPANY, people who work in that city for a company registered elsewhere still come back, so to keep out the people there, as for a local practice or shop, use CONTACT. Even then a city left out is approximate, some people listed in it still come back, while a region left out holds: never promise the founder that no one from that city remains, and never swap the city for its region without their say.", "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string", "minLength": 1, "maxLength": 80 }, "region": { "type": "string", "minLength": 1, "maxLength": 80 }, "country": { "type": "string", "minLength": 2, "maxLength": 2 } }, "required": ["country"] } }, "locationScope": { "description": "Whose address countries, places and excludedPlaces filter on: CONTACT for where the person themselves is, which is what prospects in a city means; COMPANY for where the company is registered, whose people may live elsewhere. It narrows nothing on its own and is ignored when no country and no place is given.", "type": "string", "enum": ["CONTACT", "COMPANY"] }, "departments": { "description": "Departments the champion works in.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "ENGINEERING", "FINANCE_AND_ADMINISTRATION", "HUMAN_RESOURCES", "IT_AND_IS", "MARKETING", "OPERATIONS", "SALES", "SUPPORT", "OTHER" ] } }, "seniorityLevels": { "description": "How senior the champion is.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "OWNER", "PARTNER", "EXECUTIVE", "CHIEF_OFFICER", "VICE_PRESIDENT", "DIRECTOR", "MANAGER", "SENIOR", "MID_SENIOR_LEVEL", "ASSOCIATE", "ENTRY_LEVEL", "INTERNSHIP", "UNPAID_INTERNSHIP" ] } }, "jobTitles": { "description": "Job titles the champion holds, whenever the founder names a role (Head of Sales, dentiste, CFO…), written the way people of that market write it on their profile. A title matches every job title that contains it, and several titles read as one OR the other. A title nobody holds comes back as zero leads without any error: that zero is not an empty market, reword the title.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "excludedJobTitles": { "description": "Job titles to keep OUT of the query, matched the same way: anyone whose job title contains one of them is left out, e.g. Intern or Assistant.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "includedIndustries": { "description": "Industries to keep IN the query — everything else is left out.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "AGRICULTURE_AND_MINING", "BUSINESS_SERVICES", "COMPUTERS_AND_ELECTRONICS", "CONSUMER_SERVICES", "EDUCATION", "ENERGY_AND_UTILITIES", "FINANCIAL_SERVICES", "GOVERNMENT", "HEALTHCARE_PHARMACEUTICALS_AND_BIOTECH", "MANUFACTURING", "MEDIA_AND_ENTERTAINMENT", "NON_PROFIT", "OTHER", "REAL_ESTATE_AND_CONSTRUCTION", "RETAIL", "SOFTWARE_AND_INTERNET", "TELECOMMUNICATIONS", "TRANSPORTATION_AND_STORAGE", "TRAVEL_RECREATION_AND_LEISURE", "WHOLESALE_AND_DISTRIBUTION" ] } }, "excludedIndustries": { "description": "Industries to keep OUT of the query.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "AGRICULTURE_AND_MINING", "BUSINESS_SERVICES", "COMPUTERS_AND_ELECTRONICS", "CONSUMER_SERVICES", "EDUCATION", "ENERGY_AND_UTILITIES", "FINANCIAL_SERVICES", "GOVERNMENT", "HEALTHCARE_PHARMACEUTICALS_AND_BIOTECH", "MANUFACTURING", "MEDIA_AND_ENTERTAINMENT", "NON_PROFIT", "OTHER", "REAL_ESTATE_AND_CONSTRUCTION", "RETAIL", "SOFTWARE_AND_INTERNET", "TELECOMMUNICATIONS", "TRANSPORTATION_AND_STORAGE", "TRAVEL_RECREATION_AND_LEISURE", "WHOLESALE_AND_DISTRIBUTION" ] } }, "subIndustries": { "description": "Sub-industries to keep IN the query, for a niche narrower than an industry: Medical Practice rather than all of healthcare. Send them in place of includedIndustries, never with it: the provider adds a sub-industry to a whole industry instead of narrowing it, so both together search wider than either. Several sub-industries read as one OR the other.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "Dairy", "Farming", "Fishery", "Food & Beverages", "Food Production", "Mining & Metals", "Paper & Forest Products", "Ranching", "Tobacco", "Alternative Dispute Resolution", "Animation", "Business Supplies and Equipment", "Design", "Environmental Services", "Events Services", "Executive Office", "Facilities Services", "Fund-Raising", "Graphic Design", "Human Resources", "Import and Export", "Individual & Family Services", "Information Services", "International Trade and Development", "Law Practice", "Legal Services", "Management Consulting", "Market Research", "Marketing and Advertising", "Outsourcing/Offshoring", "Professional Training & Coaching", "Program Development", "Public Relations and Communications", "Public Safety", "Security and Investigations", "Staffing and Recruiting", "Think Tanks", "Translation and Localization", "Writing and Editing", "Computer Games", "Computer Hardware", "Computer Networking", "Consumer Electronics", "Semiconductors", "Consumer Goods", "Consumer Services", "Education Management", "E-Learning", "Higher Education", "Primary/Secondary Education", "Research", "Oil & Energy", "Renewables & Environment", "Utilities", "Accounting", "Banking", "Capital Markets", "Financial Services", "Insurance", "Investment Banking", "Investment Management", "Venture Capital & Private Equity", "Defense & Space", "Government Administration", "Government Relations", "International Affairs", "Judiciary", "Law Enforcement", "Legislative Office", "Military", "Museums and Institutions", "Public Policy", "Alternative Medicine", "Biotechnology", "Health, Wellness and Fitness", "Hospital & Health Care", "Medical Devices", "Medical Practice", "Mental Health Care", "Pharmaceuticals", "Veterinary", "Automotive", "Aviation & Aerospace", "Chemicals", "Electrical/Electronic Manufacturing", "Furniture", "Industrial Automation", "Machinery", "Mechanical or Industrial Engineering", "Plastics", "Railroad Manufacture", "Shipbuilding", "Textiles", "Broadcast Media", "Media Production", "Motion Pictures and Film", "Music", "Newspapers", "Online Media", "Printing", "Publishing", "Civic & Social Organization", "Libraries", "Non-Profit Organization Management", "Philanthropy", "Political Organization", "Religious Institutions", "Arts and Crafts", "Nanotechnology", "Architecture & Planning", "Building Materials", "Civil Engineering", "Commercial Real Estate", "Construction", "Glass, Ceramics & Concrete", "Real Estate", "Apparel & Fashion", "Cosmetics", "Luxury Goods & Jewelry", "Retail", "Supermarkets", "Computer & Network Security", "Computer Software", "Information Technology and Services", "Internet", "Telecommunications", "Wireless", "Airlines/Aviation", "Logistics and Supply Chain", "Maritime", "Package/Freight Delivery", "Packaging and Containers", "Warehousing", "Transportation/Trucking/Railroad", "Entertainment", "Fine Art", "Gambling & Casinos", "Hospitality", "Leisure, Travel & Tourism", "Performing Arts", "Photography", "Recreational Facilities and Services", "Restaurants", "Sporting Goods", "Sports", "Wine and Spirits", "Wholesale" ] } }, "excludedSubIndustries": { "description": "Sub-industries to keep OUT of the query.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "Dairy", "Farming", "Fishery", "Food & Beverages", "Food Production", "Mining & Metals", "Paper & Forest Products", "Ranching", "Tobacco", "Alternative Dispute Resolution", "Animation", "Business Supplies and Equipment", "Design", "Environmental Services", "Events Services", "Executive Office", "Facilities Services", "Fund-Raising", "Graphic Design", "Human Resources", "Import and Export", "Individual & Family Services", "Information Services", "International Trade and Development", "Law Practice", "Legal Services", "Management Consulting", "Market Research", "Marketing and Advertising", "Outsourcing/Offshoring", "Professional Training & Coaching", "Program Development", "Public Relations and Communications", "Public Safety", "Security and Investigations", "Staffing and Recruiting", "Think Tanks", "Translation and Localization", "Writing and Editing", "Computer Games", "Computer Hardware", "Computer Networking", "Consumer Electronics", "Semiconductors", "Consumer Goods", "Consumer Services", "Education Management", "E-Learning", "Higher Education", "Primary/Secondary Education", "Research", "Oil & Energy", "Renewables & Environment", "Utilities", "Accounting", "Banking", "Capital Markets", "Financial Services", "Insurance", "Investment Banking", "Investment Management", "Venture Capital & Private Equity", "Defense & Space", "Government Administration", "Government Relations", "International Affairs", "Judiciary", "Law Enforcement", "Legislative Office", "Military", "Museums and Institutions", "Public Policy", "Alternative Medicine", "Biotechnology", "Health, Wellness and Fitness", "Hospital & Health Care", "Medical Devices", "Medical Practice", "Mental Health Care", "Pharmaceuticals", "Veterinary", "Automotive", "Aviation & Aerospace", "Chemicals", "Electrical/Electronic Manufacturing", "Furniture", "Industrial Automation", "Machinery", "Mechanical or Industrial Engineering", "Plastics", "Railroad Manufacture", "Shipbuilding", "Textiles", "Broadcast Media", "Media Production", "Motion Pictures and Film", "Music", "Newspapers", "Online Media", "Printing", "Publishing", "Civic & Social Organization", "Libraries", "Non-Profit Organization Management", "Philanthropy", "Political Organization", "Religious Institutions", "Arts and Crafts", "Nanotechnology", "Architecture & Planning", "Building Materials", "Civil Engineering", "Commercial Real Estate", "Construction", "Glass, Ceramics & Concrete", "Real Estate", "Apparel & Fashion", "Cosmetics", "Luxury Goods & Jewelry", "Retail", "Supermarkets", "Computer & Network Security", "Computer Software", "Information Technology and Services", "Internet", "Telecommunications", "Wireless", "Airlines/Aviation", "Logistics and Supply Chain", "Maritime", "Package/Freight Delivery", "Packaging and Containers", "Warehousing", "Transportation/Trucking/Railroad", "Entertainment", "Fine Art", "Gambling & Casinos", "Hospitality", "Leisure, Travel & Tourism", "Performing Arts", "Photography", "Recreational Facilities and Services", "Restaurants", "Sporting Goods", "Sports", "Wine and Spirits", "Wholesale" ] } }, "revenueBands": { "description": "Yearly revenue brackets of the target companies, in US dollars. Several brackets read as one OR the other.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "UP_TO_1M", "FROM_1M_TO_10M", "FROM_10M_TO_50M", "FROM_50M_TO_100M", "FROM_100M_TO_250M", "FROM_250M_TO_500M", "FROM_500M_TO_1B", "ABOVE_1B" ] } }, "headcountBands": { "description": "Employee-count brackets of the target companies. headcountMin and headcountMax say the same with numbers of your own: use them instead, never both.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "UP_TO_25", "FROM_25_TO_100", "FROM_100_TO_250", "FROM_250_TO_1000", "FROM_1K_TO_10K", "FROM_10K_TO_50K", "FROM_50K_TO_100K", "ABOVE_100K" ] } }, "headcountMin": { "description": "The fewest employees a target company may have, as a whole number, 1 or more: 500 for at least 500 employees. Use headcountMin and headcountMax in place of headcountBands, never both: given together, the brackets are refused and the numbers kept.", "type": "integer", "minimum": 1 }, "headcountMax": { "description": "The most employees a target company may have, as a whole number, 1 or more: 10 for up to 10 employees. Give it alone or with headcountMin, 11 and 50 for 11 to 50 employees.", "type": "integer", "minimum": 1 }, "technologies": { "description": "Software the target companies use, by product name (HubSpot, Shopify…), when the founder names a tool their buyers run. Several read as one OR the other. A name the provider does not know comes back as zero leads without any error: that zero is not an empty market.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "companyWebsites": { "description": "Websites of the very companies to search, as bare domains (acme.com: no https://, no path), only when the founder names those companies: nobody else comes back. A domain the provider does not hold comes back as zero leads without any error.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "lookAlikeWebsite": { "description": "The website of ONE company the founder holds up as the model of their target, as a bare domain (alan.com): the query returns companies like it. Leave it out when they named no such company.", "type": "string", "minLength": 1, "maxLength": 80 }, "fundingStages": { "description": "Funding rounds the target companies have raised. A company that never raised matches none of these, so a stage filter silently drops bootstrapped markets.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "ANGEL", "PRE_SEED", "SEED", "PRE_SERIES_A", "SERIES_A", "PRE_SERIES_B", "SERIES_B", "PRE_SERIES_C", "SERIES_C", "PRE_SERIES_D", "SERIES_D", "SERIES_E", "SERIES_F", "SERIES_G", "SERIES_H", "SERIES_I", "SERIES_J" ] } }, "companyEvents": { "description": "Recent company news to require, e.g. HIRES or RECEIVES_FINANCING. The provider gives no date for these, so never tell the founder how recent they are.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "RECEIVES_FINANCING", "HIRES", "EXPANDS_OFFICES", "GOES_PUBLIC", "ACQUIRES", "RECOGNIZED", "CLOSES_OFFICES", "IS_DEVELOPING", "HAS_ISSUES", "PROMOTES", "OPENS_NEW_LOCATION", "RECEIVES_AWARD", "INVESTS_IN_ASSETS", "SIGNS_NEW_CLIENT", "INCREASES_HEADCOUNT", "INVESTS_IN_COMPANY", "INTEGRATES", "EXPANDS_FACILITIES", "SELLS_ASSETS", "IDENTIFIED_AS_COMPETITOR", "DECREASES_HEADCOUNT", "EXPANDS_EXISTING_OFFICES", "FILES_SUIT", "MERGES" ] } }, "keywords": { "description": "Words the target COMPANY is found by, in its name or in the description of what it does, never in the person's job title: [\"orthodontie\"] finds orthodontic practices. Several read as one OR the other, so give each word its own item, in every language those companies describe themselves in: [\"dentaire\", \"dental\"]. Words written together in one item are searched as that exact phrase: \"dentaire dental\" is one rare phrase, not two words. A word no company is described by comes back as 0 without any error: that zero says nothing about their market, so try another word before concluding.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "excludedKeywords": { "description": "Words that keep a company OUT when its name or its description holds one of them. Same form as keywords: one word or exact phrase per item.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "hiringFor": { "description": "Jobs the target companies are hiring for right now, written as their job postings title them: [\"Sales Development Representative\"]. A company that recruits for a role is growing, and this filters on its open positions, never on the job title of the person contacted. Several read as one OR the other. The provider files most postings under their English title, even outside English-speaking countries: give the English title, with the local one beside it, [\"Dental Assistant\", \"Assistant dentaire\"].", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } } }}Result
Section titled “Result”Result kindlead_preview
kind"lead_preview"status"previewed" | "needs_filters" | "unsearchable" | "failed"filtersobject[]labelstring — What the filter is about, e.g. 'Company based in'.valuesstring[] — The values, in words.
notSearchedobject[]labelstring — What the filter is about, e.g. 'Company based in'.valuesstring[] — The values, in words.
ignoredstring[]returnedintegerPeople the provider returned on this preview page.
withheldintegerResults the provider held back on this page.
profilesobject[]namestringjobTitlestring | nullcompanystring | nulllocationstring | nulllinkedInUrlstring | nullcompanyLogoUrlstring | nullcompanyLinkedInUrlstring | null
messagestring | nullappUrlstringOutput schema
{ "type": "object", "properties": { "kind": { "type": "string", "const": "lead_preview" }, "status": { "type": "string", "enum": ["previewed", "needs_filters", "unsearchable", "failed"] }, "filters": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "What the filter is about, e.g. 'Company based in'." }, "values": { "type": "array", "items": { "type": "string" }, "description": "The values, in words." } }, "required": ["label", "values"], "additionalProperties": false } }, "notSearched": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "What the filter is about, e.g. 'Company based in'." }, "values": { "type": "array", "items": { "type": "string" }, "description": "The values, in words." } }, "required": ["label", "values"], "additionalProperties": false } }, "ignored": { "type": "array", "items": { "type": "string" } }, "returned": { "type": "integer", "description": "People the provider returned on this preview page." }, "withheld": { "type": "integer", "description": "Results the provider held back on this page." }, "profiles": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "jobTitle": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "linkedInUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "companyLogoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "companyLinkedInUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "jobTitle", "company", "location", "linkedInUrl", "companyLogoUrl", "companyLinkedInUrl" ], "additionalProperties": false } }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "appUrl": { "type": "string" } }, "required": [ "kind", "status", "filters", "notSearched", "ignored", "returned", "withheld", "profiles", "message", "appUrl" ], "additionalProperties": false}Good to know
Section titled “Good to know”- A preview never includes email addresses: those come only with import_leads, on the user's click.
- The user must see a preview of the current target before confirm_target is accepted.
- Same filters and vocabulary as estimate_lead_pool.