Create Technographic Audience
create_technographic_audienceCreates B2B audiences based on technology stack, software usage, and firmographic attributes.
ESTIMATE-ONLY MODE:
Pass estimate_only=true to preview audience size (companies + contacts) WITHOUT creating the audience.
In this mode the tool returns expectedNumberOfCompanies,
expectedNumberOfContacts, and cappedContactCount. Default is false (audience is created).
WHEN TO USE:
- Target companies using specific technologies or software
- Create audiences based on technology adoption patterns
- Target by technology categories (CRM, Marketing Automation, Analytics, etc.)
- Combine technology targeting with firmographic filters
- Build tech-savvy audience segments for B2B campaigns
- User wants to target companies and contacts that are familiar/using some specific software like hubspot, g2, etc.
TECHNOLOGY CATEGORIES:
- CRM: Salesforce, HubSpot, Microsoft Dynamics, Zoho, Pipedrive
- Marketing Automation: Marketo, Pardot, Eloqua, HubSpot, Mailchimp
- Analytics: Google Analytics, Adobe Analytics, Mixpanel, Amplitude
- E-commerce: Shopify, Magento, WooCommerce, BigCommerce
- Content Management: WordPress, Drupal, Joomla, Adobe Experience Manager
- Collaboration: Slack, Microsoft Teams, Zoom, Asana, Monday.com
- Cloud Infrastructure: AWS, Azure, Google Cloud, Oracle Cloud
- Database: MySQL, PostgreSQL, MongoDB, Oracle, SQL Server
- And many more technology categories available
FIRMOGRAPHIC FILTERS (OPTIONAL):
- Industries: Use industry IDs (1-148, same as firmographic audiences)
- Employees: "LESS_THAN_10", "FROM_10_TO_50", "FROM_50_TO_200", "FROM_200_TO_500", "FROM_500_TO_1000", "FROM_1000_TO_5000", "FROM_5000_TO_10000", "OVER_10000"
- Revenue: "LESS_THAN_1M", "FROM_1M_TO_10M", "FROM_10M_TO_50M", "FROM_50M_TO_100M", "FROM_100M_TO_200M", "FROM_200M_TO_500M", "FROM_500M_TO_1000M", "OVER_1000M"
CONTACTS CRITERIA:
Use the following parameters to filter and target specific contacts within accounts:
GEOGRAPHIC TARGETING:
location_country_ids: Array of country IDs (e.g., [29] for Brazil, [229] for United States)
location_state_ids: Array of state IDs (e.g., [5] for California, [32] for New York)
JOB TITLES:
job_title_includes: Array of free text strings to include (e.g., ["Software Engineer", "Manager"])
job_title_excludes: Array of free text strings to exclude (e.g., ["Senior", "Lead"])
JOB FUNCTIONS: Valid job function IDs and their labels:
1: Marketing, 2: Sales, 3: Customer Service, 4: Finance, 5: Human Resources, 6: Public Relations
7: Media, 8: Design, 9: Engineering, 10: Operations, 11: Legal, 12: Education
13: Health, 14: Real Estate, 15: Accounting, 16: Administrative, 17: Business Development
18: Community and Social Services, 19: Consulting, 20: Entrepreneurship, 21: Information Technology
22: Military and Protective Services, 23: Product Management, 24: Program and Project Management
25: Purchasing, 26: Quality Assurance, 27: Research, 28: Trades
job_function_include_ids: Array of job function IDs to include (e.g., [9] for Engineering)
job_function_exclude_ids: Array of job function IDs to exclude
SENIORITY LEVELS: Valid seniority IDs and their labels:
2: Manager, 3: Director, 4: VP, 5: CXO, 6: Unpaid, 7: Training
8: Senior, 9: Owner, 10: Entry, 11: Partner
seniority_include_ids: Array of seniority level IDs to include (e.g., [10, 7] for Entry and Training)
seniority_exclude_ids: Array of seniority level IDs to exclude
CONTACT LIMITS:
contacts_per_company_limit: Maximum number of contacts to target per company (optional). Example: 20
USAGE NOTES:
All ID fields (countries, states, job functions, seniorities) use numeric IDs from the platform
Job titles are free text strings, not IDs
Use include parameters to specify which criteria to target
Use exclude parameters to filter out contacts matching specific criteria
Combine multiple criteria for precise targeting (e.g., Senior Engineers in California)
Criteria are combined with AND logic, so all conditions must be met
CONTACTS CRITERIA PARAMETERS(Usually after other initial audience parameters to be described next):
location_country_ids: Array of country IDs (optional)
location_state_ids: Array of state IDs (optional)
job_title_includes: Array of job title keywords to include (optional)
job_title_excludes: Array of job title keywords to exclude (optional)
job_function_include_ids: Array of job function IDs (optional)
job_function_exclude_ids: Array of job function IDs (optional)
seniority_include_ids: Array of seniority level IDs (optional)
seniority_exclude_ids: Array of seniority level IDs (optional)
contacts_per_company_limit: Maximum contacts per company (optional)
PARAMETERS: - name: Audience name (required) - **IMPORTANT: Name MUST NOT exceed 50 characters. This is a mandatory requirement.** - technologies: Array of technology names (required) - industries: Array of industry IDs (optional) - employees: Array of employee count ranges (optional) - revenue: Array of revenue ranges (optional) RETURNS: Audience details with ID, size estimation, and creation status, plus `technologies_requested`, `technologies_targeted` (the indexed names actually sent) and `technology_resolution`. COMMON USE CASES: - Target companies using Salesforce and HubSpot - Find AWS users in the software industry - Build audiences of companies using specific MarTech stacks - Combine technology and firmographic targeting for precise B2B campaigns IMPORTANT NOTES: - **CRITICAL: Audience name MUST NOT exceed 50 characters - this is mandatory and will cause creation to fail if exceeded** - name and technologies are required parameters - All other parameters are optional for flexible audience creation - Technology names are resolved against the platform's indexed product catalog: an exact name is used as given; otherwise the closest indexed match is used and reported back in `technology_resolution` (requested, used, exact_match, alternatives) plus a plain-words `technology_note`. A name with no catalog match fails the call with an error; nothing is dropped silently. - When the call fails as too small and the error names a substituted technology, retry with one of the listed alternatives or a broader technology name. Do NOT loosen industries, seniority, employee bands or countries first: the substituted product is the cause. - Contact criteria fields work the same as in other audience types - Audience size depends on technology filters and applied criteria
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Audience name (required). Maximum 50 characters. | |
| revenue | No | Revenue ranges for firmographic filtering (optional). Valid enum values: LESS_THAN_1M ($0-$1M), FROM_1M_TO_10M ($1M-$10M), FROM_10M_TO_50M ($10M-$50M), FROM_50M_TO_100M ($50M-$100M), FROM_100M_TO_200M ($100M-$200M), FROM_200M_TO_500M ($200M-$500M), FROM_500M_TO_1000M ($500M-$1B), OVER_1000M ($1B+). Example: ['FROM_10M_TO_50M', 'FROM_50M_TO_100M'] | |
| employees | No | Employee count ranges for firmographic filtering (optional). Valid enum values: LESS_THAN_10 (0-9), FROM_10_TO_50 (10-49), FROM_50_TO_200 (50-199), FROM_200_TO_500 (200-499), FROM_500_TO_1000 (500-999), FROM_1000_TO_5000 (1,000-4,999), FROM_5000_TO_10000 (5,000-9,999), OVER_10000 (10,000+). Example: ['FROM_50_TO_200', 'FROM_200_TO_500'] | |
| industries | No | Industry IDs for firmographic/technographic filtering (optional). Valid IDs: 1=Defense & Space, 3=Computer Hardware, 4=Computer Software, 5=Computer Networking, 6=Internet, 7=Semiconductors, 8=Telecommunications, 9=Law Practice, 10=Legal Services, 11=Management Consulting, 12=Biotechnology, 13=Medical Practice, 14=Hospital & Health Care, 15=Pharmaceuticals, 16=Veterinary, 17=Medical Device, 18=Cosmetics, 19=Apparel & Fashion, 20=Sporting Goods, 21=Tobacco, 22=Supermarkets, 23=Food Production, 24=Consumer Electronics, 25=Consumer Goods, 26=Furniture, 27=Retail, 28=Entertainment, 29=Gambling & Casinos, 30=Leisure, Travel & Tourism, 31=Hospitality, 32=Restaurants, 33=Sports, 34=Food & Beverages, 35=Motion Pictures & Film, 36=Broadcast Media, 37=Museums & Institutions, 38=Fine Art, 39=Performing Arts, 40=Recreational Facilities & Services, 41=Banking, 42=Insurance, 43=Financial Services, 44=Real Estate, 45=Investment Banking, 46=Investment Management, 47=Accounting, 48=Construction, 49=Building Materials, 50=Architecture & Planning, 51=Civil Engineering, 52=Aviation & Aerospace, 53=Automotive, 54=Chemicals, 55=Machinery, 56=Mining & Metals, 57=Oil & Energy, 58=Shipbuilding, 59=Utilities, 60=Textiles, 61=Paper & Forest Products, 62=Railroad Manufacture, 63=Farming, 64=Ranching, 65=Dairy, 66=Fishery, 67=Primary/Secondary Education, 68=Higher Education, 69=Education Management, 70=Research, 71=Military, 72=Legislative Office, 73=Judiciary, 74=International Affairs, 75=Government Administration, 76=Executive Office, 77=Law Enforcement, 78=Public Safety, 79=Public Policy, 80=Marketing & Advertising, 81=Newspapers, 82=Publishing, 83=Printing, 84=Information Services, 85=Libraries, 86=Environmental Services, 87=Package/Freight Delivery, 88=Individual & Family Services, 89=Religious Institutions, 90=Civic & Social Organization, 91=Consumer Services, 92=Transportation/Trucking/Railroad, 93=Warehousing, 94=Airlines/Aviation, 95=Maritime, 96=Information Technology & Services, 97=Market Research, 98=Public Relations & Communications, 99=Design, 100=Non-profit Organization Management, 101=Fundraising, 102=Program Development, 103=Writing & Editing, 104=Staffing & Recruiting, 105=Professional Training & Coaching, 106=Venture Capital & Private Equity, 107=Political Organization, 108=Translation & Localization, 109=Computer Games, 110=Events Services, 111=Arts & Crafts, 112=Electrical & Electronic Manufacturing, 113=Online Media, 114=Nanotechnology, 115=Music, 116=Logistics & Supply Chain, 117=Plastics, 118=Computer & Network Security, 119=Wireless, 120=Alternative Dispute Resolution, 121=Security & Investigations, 122=Facilities Services, 123=Outsourcing/Offshoring, 124=Health, Wellness & Fitness, 125=Alternative Medicine, 126=Media Production, 127=Animation, 128=Commercial Real Estate, 129=Capital Markets, 130=Think Tanks, 131=Philanthropy, 132=E-learning, 133=Wholesale, 134=Import & Export, 135=Mechanical Or Industrial Engineering, 136=Photography, 137=Human Resources, 138=Business Supplies & Equipment, 139=Mental Health Care, 140=Graphic Design, 141=International Trade & Development, 142=Wine & Spirits, 143=Luxury Goods & Jewelry, 144=Renewables & Environment, 145=Glass, Ceramics & Concrete, 146=Packaging & Containers, 147=Industrial Automation, 148=Government Relations. Example: [4, 96, 11] for Software, IT Services, Consulting | |
| technologies | Yes | Array of technology names to target (required). Example: ['Salesforce', 'HubSpot', 'Marketo'] | |
| estimate_only | No | If true, do NOT create the audience — only estimate its size and return the counts. Use this when the user wants to preview how many companies/contacts match the criteria before committing. Defaults to false (audience is created). | |
| job_title_excludes | No | Free text keywords for job titles to exclude (optional). Example: ['Senior', 'Lead'] | |
| job_title_includes | No | Free text keywords for job titles to include (optional). Example: ['Software Engineer', 'Manager'] | |
| location_state_ids | No | State IDs for geographic targeting (optional). Valid US State IDs: 1 (Alabama), 2 (Alaska), 3 (Arizona), 4 (Arkansas), 5 (California), 6 (Colorado), 7 (Connecticut), 8 (Delaware), 9 (Florida), 10 (Georgia), 11 (Hawaii), 12 (Idaho), 13 (Illinois), 14 (Indiana), 15 (Iowa), 16 (Kansas), 17 (Kentucky), 18 (Louisiana), 19 (Maine), 20 (Maryland), 21 (Massachusetts), 22 (Michigan), 23 (Minnesota), 24 (Mississippi), 25 (Missouri), 26 (Montana), 27 (Nebraska), 28 (Nevada), 29 (New Hampshire), 30 (New Jersey), 31 (New Mexico), 32 (New York), 33 (North Carolina), 34 (North Dakota), 35 (Ohio), 36 (Oklahoma), 37 (Oregon), 38 (Pennsylvania), 39 (Rhode Island), 40 (South Carolina), 41 (South Dakota), 42 (Tennessee), 43 (Texas), 44 (Utah), 45 (Vermont), 46 (Virginia), 47 (Washington), 48 (West Virginia), 49 (Wisconsin), 50 (Wyoming), 52 (District of Columbia). Example: [5] for California, [32] for New York | |
| location_country_ids | No | Country IDs for geographic targeting (optional). Valid IDs: 1 (Afghanistan), 2 (Albania), 3 (Algeria), 4 (American Samoa), 5 (Andorra), 6 (Angola), 7 (Anguilla), 8 (Antarctica), 9 (Antigua and Barbuda), 10 (Argentina), 11 (Armenia), 12 (Aruba), 13 (Australia), 14 (Austria), 15 (Azerbaijan), 16 (Bahamas), 17 (Bahrain), 18 (Bangladesh), 19 (Barbados), 20 (Belarus), 21 (Belgium), 22 (Belize), 23 (Benin), 24 (Bermuda), 25 (Bhutan), 26 (Bolivia), 27 (Bosnia and Herzegovina), 28 (Botswana), 29 (Brazil), 30 (British Indian Ocean Territory), 31 (British Virgin Islands), 32 (Brunei), 33 (Bulgaria), 34 (Burkina Faso), 35 (Burundi), 36 (Cambodia), 37 (Cameroon), 38 (Canada), 39 (Cape Verde), 40 (Cayman Islands), 41 (Central African Republic), 42 (Chad), 43 (Chile), 44 (China), 45 (Christmas Island), 46 (Cocos Islands), 47 (Colombia), 48 (Comoros), 49 (Cook Islands), 50 (Costa Rica), 51 (Croatia), 53 (Curacao), 54 (Cyprus), 55 (Czech Republic), 56 (Democratic Republic of the Congo), 57 (Denmark), 58 (Djibouti), 59 (Dominica), 60 (Dominican Republic), 61 (East Timor), 62 (Ecuador), 63 (Egypt), 64 (El Salvador), 65 (Equatorial Guinea), 66 (Eritrea), 67 (Estonia), 68 (Ethiopia), 69 (Falkland Islands), 70 (Faroe Islands), 71 (Fiji), 72 (Finland), 73 (France), 74 (French Polynesia), 75 (Gabon), 76 (Gambia), 77 (Georgia), 78 (Germany), 79 (Ghana), 80 (Gibraltar), 81 (Greece), 82 (Greenland), 83 (Grenada), 84 (Guam), 85 (Guatemala), 86 (Guernsey), 87 (Guinea), 88 (Guinea-Bissau), 89 (Guyana), 90 (Haiti), 91 (Honduras), 92 (Hong Kong), 93 (Hungary), 94 (Iceland), 95 (India), 96 (Indonesia), 98 (Iraq), 99 (Ireland), 100 (Isle of Man), 101 (Israel), 102 (Italy), 103 (Ivory Coast), 104 (Jamaica), 105 (Japan), 106 (Jersey), 107 (Jordan), 108 (Kazakhstan), 109 (Kenya), 110 (Kiribati), 111 (Kosovo), 112 (Kuwait), 113 (Kyrgyzstan), 114 (Laos), 115 (Latvia), 116 (Lebanon), 117 (Lesotho), 118 (Liberia), 119 (Libya), 120 (Liechtenstein), 121 (Lithuania), 122 (Luxembourg), 123 (Macau), 124 (Macedonia), 125 (Madagascar), 126 (Malawi), 127 (Malaysia), 128 (Maldives), 129 (Mali), 130 (Malta), 131 (Marshall Islands), 132 (Mauritania), 133 (Mauritius), 134 (Mayotte), 135 (Mexico), 136 (Micronesia), 137 (Moldova), 138 (Monaco), 139 (Mongolia), 140 (Montenegro), 141 (Montserrat), 142 (Morocco), 143 (Mozambique), 144 (Myanmar), 145 (Namibia), 146 (Nauru), 147 (Nepal), 148 (Netherlands), 149 (Netherlands Antilles), 150 (New Caledonia), 151 (New Zealand), 152 (Nicaragua), 153 (Niger), 154 (Nigeria), 155 (Niue), 157 (Northern Mariana Islands), 158 (Norway), 159 (Oman), 160 (Pakistan), 161 (Palau), 162 (Palestine), 163 (Panama), 164 (Papua New Guinea), 165 (Paraguay), 166 (Peru), 167 (Philippines), 168 (Pitcairn), 169 (Poland), 170 (Portugal), 171 (Puerto Rico), 172 (Qatar), 173 (Republic of the Congo), 174 (Reunion), 175 (Romania), 176 (Russia), 177 (Rwanda), 178 (Saint Barthelemy), 179 (Saint Helena), 180 (Saint Kitts and Nevis), 181 (Saint Lucia), 182 (Saint Martin), 183 (Saint Pierre and Miquelon), 184 (Saint Vincent and the Grenadines), 185 (Samoa), 186 (San Marino), 187 (Sao Tome and Principe), 188 (Saudi Arabia), 189 (Senegal), 190 (Serbia), 191 (Seychelles), 192 (Sierra Leone), 193 (Singapore), 194 (Sint Maarten), 195 (Slovakia), 196 (Slovenia), 197 (Solomon Islands), 198 (Somalia), 199 (South Africa), 200 (South Korea), 201 (South Sudan), 202 (Spain), 203 (Sri Lanka), 205 (Suriname), 206 (Svalbard and Jan Mayen), 207 (Swaziland), 208 (Sweden), 209 (Switzerland), 211 (Taiwan), 212 (Tajikistan), 213 (Tanzania), 214 (Thailand), 215 (Togo), 216 (Tokelau), 217 (Tonga), 218 (Trinidad and Tobago), 219 (Tunisia), 220 (Turkey), 221 (Turkmenistan), 222 (Turks and Caicos Islands), 223 (Tuvalu), 224 (U.S. Virgin Islands), 225 (Uganda), 226 (Ukraine), 227 (United Arab Emirates), 228 (United Kingdom), 229 (United States), 230 (Uruguay), 231 (Uzbekistan), 232 (Vanuatu), 233 (Vatican), 234 (Venezuela), 235 (Vietnam), 236 (Wallis and Futuna), 237 (Western Sahara), 238 (Yemen), 239 (Zambia), 240 (Zimbabwe), 241 (Guadeloupe). Example: [29] for Brazil, [229] for United States | |
| seniority_exclude_ids | No | Seniority level IDs to exclude (optional). Valid IDs: 2-11 as listed above | |
| seniority_include_ids | No | Seniority level IDs to include (optional). Valid IDs: 2 (Manager), 3 (Director), 4 (VP), 5 (CXO), 6 (Unpaid), 7 (Training), 8 (Senior), 9 (Owner), 10 (Entry), 11 (Partner). Example: [10, 7] for Entry and Training | |
| job_function_exclude_ids | No | Job function IDs to exclude (optional). Valid IDs: 1-28 as listed above | |
| job_function_include_ids | No | Job function IDs to include (optional). Valid IDs: 1 (Marketing), 2 (Sales), 3 (Customer Service), 4 (Finance), 5 (HR), 6 (PR), 7 (Media), 8 (Design), 9 (Engineering), 10 (Operations), 11 (Legal), 12 (Education), 13 (Health), 14 (Real Estate), 15 (Accounting), 16 (Administrative), 17 (Business Development), 18 (Community Services), 19 (Consulting), 20 (Entrepreneurship), 21 (IT), 22 (Military Services), 23 (Product Management), 24 (Program/Project Management), 25 (Purchasing), 26 (QA), 27 (Research), 28 (Trades). Example: [9] for Engineering | |
| contacts_per_company_limit | No | Maximum number of contacts to target per company (optional). Example: 20 |