brand.dev 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,9 +6,13 @@ import { RequestOptions } from '../internal/request-options';
6
6
 
7
7
  export class Brand extends APIResource {
8
8
  /**
9
- * Retrieve brand data by domain
9
+ * Retrieve brand information using one of three methods: domain name, company
10
+ * name, or stock ticker symbol. Exactly one of these parameters must be provided.
10
11
  */
11
- retrieve(query: BrandRetrieveParams, options?: RequestOptions): APIPromise<BrandRetrieveResponse> {
12
+ retrieve(
13
+ query: BrandRetrieveParams | null | undefined = {},
14
+ options?: RequestOptions,
15
+ ): APIPromise<BrandRetrieveResponse> {
12
16
  return this._client.get('/brand/retrieve', { query, ...options });
13
17
  }
14
18
 
@@ -42,16 +46,6 @@ export class Brand extends APIResource {
42
46
  return this._client.post('/brand/prefetch', { body, ...options });
43
47
  }
44
48
 
45
- /**
46
- * Retrieve brand data by stock ticker (e.g. AAPL, TSLA, etc.)
47
- */
48
- retrieveByTicker(
49
- query: BrandRetrieveByTickerParams,
50
- options?: RequestOptions,
51
- ): APIPromise<BrandRetrieveByTickerResponse> {
52
- return this._client.get('/brand/retrieve-by-ticker', { query, ...options });
53
- }
54
-
55
49
  /**
56
50
  * Endpoint to classify any brand into a 2022 NAICS code.
57
51
  */
@@ -145,6 +139,11 @@ export namespace BrandRetrieveResponse {
145
139
  */
146
140
  email?: string;
147
141
 
142
+ /**
143
+ * Industry classification information for the brand
144
+ */
145
+ industries?: Brand.Industries;
146
+
148
147
  /**
149
148
  * Indicates whether the brand content is not safe for work (NSFW)
150
149
  */
@@ -286,6 +285,274 @@ export namespace BrandRetrieveResponse {
286
285
  name?: string;
287
286
  }
288
287
 
288
+ /**
289
+ * Industry classification information for the brand
290
+ */
291
+ export interface Industries {
292
+ /**
293
+ * Easy Industry Classification - array of industry and subindustry pairs
294
+ */
295
+ eic?: Array<Industries.Eic>;
296
+ }
297
+
298
+ export namespace Industries {
299
+ export interface Eic {
300
+ /**
301
+ * Industry classification enum
302
+ */
303
+ industry:
304
+ | 'Aerospace & Defense'
305
+ | 'Technology'
306
+ | 'Finance'
307
+ | 'Healthcare'
308
+ | 'Retail & E-commerce'
309
+ | 'Entertainment'
310
+ | 'Education'
311
+ | 'Government & Nonprofit'
312
+ | 'Industrial & Energy'
313
+ | 'Automotive & Transportation'
314
+ | 'Lifestyle & Leisure'
315
+ | 'Luxury & Fashion'
316
+ | 'News & Media'
317
+ | 'Sports'
318
+ | 'Real Estate & PropTech'
319
+ | 'Legal & Compliance'
320
+ | 'Telecommunications'
321
+ | 'Agriculture & Food'
322
+ | 'Professional Services & Agencies'
323
+ | 'Chemicals & Materials'
324
+ | 'Logistics & Supply Chain'
325
+ | 'Hospitality & Tourism'
326
+ | 'Construction & Built Environment'
327
+ | 'Consumer Packaged Goods (CPG)';
328
+
329
+ /**
330
+ * Subindustry classification enum
331
+ */
332
+ subindustry:
333
+ | 'Defense Systems & Military Hardware'
334
+ | 'Aerospace Manufacturing'
335
+ | 'Avionics & Navigation Technology'
336
+ | 'Subsea & Naval Defense Systems'
337
+ | 'Space & Satellite Technology'
338
+ | 'Defense IT & Systems Integration'
339
+ | 'Software (B2B)'
340
+ | 'Software (B2C)'
341
+ | 'Cloud Infrastructure & DevOps'
342
+ | 'Cybersecurity'
343
+ | 'Artificial Intelligence & Machine Learning'
344
+ | 'Data Infrastructure & Analytics'
345
+ | 'Hardware & Semiconductors'
346
+ | 'Fintech Infrastructure'
347
+ | 'eCommerce & Marketplace Platforms'
348
+ | 'Developer Tools & APIs'
349
+ | 'Web3 & Blockchain'
350
+ | 'XR & Spatial Computing'
351
+ | 'Banking & Lending'
352
+ | 'Investment Management & WealthTech'
353
+ | 'Insurance & InsurTech'
354
+ | 'Payments & Money Movement'
355
+ | 'Accounting, Tax & Financial Planning Tools'
356
+ | 'Capital Markets & Trading Platforms'
357
+ | 'Financial Infrastructure & APIs'
358
+ | 'Credit Scoring & Risk Management'
359
+ | 'Cryptocurrency & Digital Assets'
360
+ | 'BNPL & Alternative Financing'
361
+ | 'Healthcare Providers & Services'
362
+ | 'Pharmaceuticals & Drug Development'
363
+ | 'Medical Devices & Diagnostics'
364
+ | 'Biotechnology & Genomics'
365
+ | 'Digital Health & Telemedicine'
366
+ | 'Health Insurance & Benefits Tech'
367
+ | 'Clinical Trials & Research Platforms'
368
+ | 'Mental Health & Wellness'
369
+ | 'Healthcare IT & EHR Systems'
370
+ | 'Consumer Health & Wellness Products'
371
+ | 'Online Marketplaces'
372
+ | 'Direct-to-Consumer (DTC) Brands'
373
+ | 'Retail Tech & Point-of-Sale Systems'
374
+ | 'Omnichannel & In-Store Retail'
375
+ | 'E-commerce Enablement & Infrastructure'
376
+ | 'Subscription & Membership Commerce'
377
+ | 'Social Commerce & Influencer Platforms'
378
+ | 'Fashion & Apparel Retail'
379
+ | 'Food, Beverage & Grocery E-commerce'
380
+ | 'Streaming Platforms (Video, Music, Audio)'
381
+ | 'Gaming & Interactive Entertainment'
382
+ | 'Creator Economy & Influencer Platforms'
383
+ | 'Advertising, Adtech & Media Buying'
384
+ | 'Film, TV & Production Studios'
385
+ | 'Events, Venues & Live Entertainment'
386
+ | 'Virtual Worlds & Metaverse Experiences'
387
+ | 'K-12 Education Platforms & Tools'
388
+ | 'Higher Education & University Tech'
389
+ | 'Online Learning & MOOCs'
390
+ | 'Test Prep & Certification'
391
+ | 'Corporate Training & Upskilling'
392
+ | 'Tutoring & Supplemental Learning'
393
+ | 'Education Management Systems (LMS/SIS)'
394
+ | 'Language Learning'
395
+ | 'Creator-Led & Cohort-Based Courses'
396
+ | 'Special Education & Accessibility Tools'
397
+ | 'Government Technology & Digital Services'
398
+ | 'Civic Engagement & Policy Platforms'
399
+ | 'International Development & Humanitarian Aid'
400
+ | 'Philanthropy & Grantmaking'
401
+ | 'Nonprofit Operations & Fundraising Tools'
402
+ | 'Public Health & Social Services'
403
+ | 'Education & Youth Development Programs'
404
+ | 'Environmental & Climate Action Organizations'
405
+ | 'Legal Aid & Social Justice Advocacy'
406
+ | 'Municipal & Infrastructure Services'
407
+ | 'Manufacturing & Industrial Automation'
408
+ | 'Energy Production (Oil, Gas, Nuclear)'
409
+ | 'Renewable Energy & Cleantech'
410
+ | 'Utilities & Grid Infrastructure'
411
+ | 'Industrial IoT & Monitoring Systems'
412
+ | 'Construction & Heavy Equipment'
413
+ | 'Mining & Natural Resources'
414
+ | 'Environmental Engineering & Sustainability'
415
+ | 'Energy Storage & Battery Technology'
416
+ | 'Automotive OEMs & Vehicle Manufacturing'
417
+ | 'Electric Vehicles (EVs) & Charging Infrastructure'
418
+ | 'Mobility-as-a-Service (MaaS)'
419
+ | 'Fleet Management'
420
+ | 'Public Transit & Urban Mobility'
421
+ | 'Autonomous Vehicles & ADAS'
422
+ | 'Aftermarket Parts & Services'
423
+ | 'Telematics & Vehicle Connectivity'
424
+ | 'Aviation & Aerospace Transport'
425
+ | 'Maritime Shipping'
426
+ | 'Fitness & Wellness'
427
+ | 'Beauty & Personal Care'
428
+ | 'Home & Living'
429
+ | 'Dating & Relationships'
430
+ | 'Hobbies, Crafts & DIY'
431
+ | 'Outdoor & Recreational Gear'
432
+ | 'Events, Experiences & Ticketing Platforms'
433
+ | 'Designer & Luxury Apparel'
434
+ | 'Accessories, Jewelry & Watches'
435
+ | 'Footwear & Leather Goods'
436
+ | 'Beauty, Fragrance & Skincare'
437
+ | 'Fashion Marketplaces & Retail Platforms'
438
+ | 'Sustainable & Ethical Fashion'
439
+ | 'Resale, Vintage & Circular Fashion'
440
+ | 'Fashion Tech & Virtual Try-Ons'
441
+ | 'Streetwear & Emerging Luxury'
442
+ | 'Couture & Made-to-Measure'
443
+ | 'News Publishing & Journalism'
444
+ | 'Digital Media & Content Platforms'
445
+ | 'Broadcasting (TV & Radio)'
446
+ | 'Podcasting & Audio Media'
447
+ | 'News Aggregators & Curation Tools'
448
+ | 'Independent & Creator-Led Media'
449
+ | 'Newsletters & Substack-Style Platforms'
450
+ | 'Political & Investigative Media'
451
+ | 'Trade & Niche Publications'
452
+ | 'Media Monitoring & Analytics'
453
+ | 'Professional Teams & Leagues'
454
+ | 'Sports Media & Broadcasting'
455
+ | 'Sports Betting & Fantasy Sports'
456
+ | 'Fitness & Athletic Training Platforms'
457
+ | 'Sportswear & Equipment'
458
+ | 'Esports & Competitive Gaming'
459
+ | 'Sports Venues & Event Management'
460
+ | 'Athlete Management & Talent Agencies'
461
+ | 'Sports Tech & Performance Analytics'
462
+ | 'Youth, Amateur & Collegiate Sports'
463
+ | 'Real Estate Marketplaces'
464
+ | 'Property Management Software'
465
+ | 'Rental Platforms'
466
+ | 'Mortgage & Lending Tech'
467
+ | 'Real Estate Investment Platforms'
468
+ | 'Law Firms & Legal Services'
469
+ | 'Legal Tech & Automation'
470
+ | 'Regulatory Compliance'
471
+ | 'E-Discovery & Litigation Tools'
472
+ | 'Contract Management'
473
+ | 'Governance, Risk & Compliance (GRC)'
474
+ | 'IP & Trademark Management'
475
+ | 'Legal Research & Intelligence'
476
+ | 'Compliance Training & Certification'
477
+ | 'Whistleblower & Ethics Reporting'
478
+ | 'Mobile & Wireless Networks (3G/4G/5G)'
479
+ | 'Broadband & Fiber Internet'
480
+ | 'Satellite & Space-Based Communications'
481
+ | 'Network Equipment & Infrastructure'
482
+ | 'Telecom Billing & OSS/BSS Systems'
483
+ | 'VoIP & Unified Communications'
484
+ | 'Internet Service Providers (ISPs)'
485
+ | 'Edge Computing & Network Virtualization'
486
+ | 'IoT Connectivity Platforms'
487
+ | 'Precision Agriculture & AgTech'
488
+ | 'Crop & Livestock Production'
489
+ | 'Food & Beverage Manufacturing & Processing'
490
+ | 'Food Distribution'
491
+ | 'Restaurants & Food Service'
492
+ | 'Agricultural Inputs & Equipment'
493
+ | 'Sustainable & Regenerative Agriculture'
494
+ | 'Seafood & Aquaculture'
495
+ | 'Management Consulting'
496
+ | 'Marketing & Advertising Agencies'
497
+ | 'Design, Branding & Creative Studios'
498
+ | 'IT Services & Managed Services'
499
+ | 'Staffing, Recruiting & Talent'
500
+ | 'Accounting & Tax Firms'
501
+ | 'Public Relations & Communications'
502
+ | 'Business Process Outsourcing (BPO)'
503
+ | 'Professional Training & Coaching'
504
+ | 'Specialty Chemicals'
505
+ | 'Commodity & Petrochemicals'
506
+ | 'Polymers, Plastics & Rubber'
507
+ | 'Coatings, Adhesives & Sealants'
508
+ | 'Industrial Gases'
509
+ | 'Advanced Materials & Composites'
510
+ | 'Battery Materials & Energy Storage'
511
+ | 'Electronic Materials & Semiconductor Chemicals'
512
+ | 'Agrochemicals & Fertilizers'
513
+ | 'Freight & Transportation Tech'
514
+ | 'Last-Mile Delivery'
515
+ | 'Warehouse Automation'
516
+ | 'Supply Chain Visibility Platforms'
517
+ | 'Logistics Marketplaces'
518
+ | 'Shipping & Freight Forwarding'
519
+ | 'Cold Chain Logistics'
520
+ | 'Reverse Logistics & Returns'
521
+ | 'Cross-Border Trade Tech'
522
+ | 'Transportation Management Systems (TMS)'
523
+ | 'Hotels & Accommodation'
524
+ | 'Vacation Rentals & Short-Term Stays'
525
+ | 'Restaurant Tech & Management'
526
+ | 'Travel Booking Platforms'
527
+ | 'Tourism Experiences & Activities'
528
+ | 'Cruise Lines & Marine Tourism'
529
+ | 'Hospitality Management Systems'
530
+ | 'Event & Venue Management'
531
+ | 'Corporate Travel Management'
532
+ | 'Travel Insurance & Protection'
533
+ | 'Construction Management Software'
534
+ | 'BIM/CAD & Design Tools'
535
+ | 'Construction Marketplaces'
536
+ | 'Equipment Rental & Management'
537
+ | 'Building Materials & Procurement'
538
+ | 'Construction Workforce Management'
539
+ | 'Project Estimation & Bidding'
540
+ | 'Modular & Prefab Construction'
541
+ | 'Construction Safety & Compliance'
542
+ | 'Smart Building Technology'
543
+ | 'Food & Beverage CPG'
544
+ | 'Home & Personal Care CPG'
545
+ | 'CPG Analytics & Insights'
546
+ | 'Direct-to-Consumer CPG Brands'
547
+ | 'CPG Supply Chain & Distribution'
548
+ | 'Private Label Manufacturing'
549
+ | 'CPG Retail Intelligence'
550
+ | 'Sustainable CPG & Packaging'
551
+ | 'Beauty & Cosmetics CPG'
552
+ | 'Health & Wellness CPG';
553
+ }
554
+ }
555
+
289
556
  export interface Logo {
290
557
  /**
291
558
  * Array of colors in the logo
@@ -467,6 +734,11 @@ export namespace BrandIdentifyFromTransactionResponse {
467
734
  */
468
735
  email?: string;
469
736
 
737
+ /**
738
+ * Industry classification information for the brand
739
+ */
740
+ industries?: Brand.Industries;
741
+
470
742
  /**
471
743
  * Indicates whether the brand content is not safe for work (NSFW)
472
744
  */
@@ -608,6 +880,274 @@ export namespace BrandIdentifyFromTransactionResponse {
608
880
  name?: string;
609
881
  }
610
882
 
883
+ /**
884
+ * Industry classification information for the brand
885
+ */
886
+ export interface Industries {
887
+ /**
888
+ * Easy Industry Classification - array of industry and subindustry pairs
889
+ */
890
+ eic?: Array<Industries.Eic>;
891
+ }
892
+
893
+ export namespace Industries {
894
+ export interface Eic {
895
+ /**
896
+ * Industry classification enum
897
+ */
898
+ industry:
899
+ | 'Aerospace & Defense'
900
+ | 'Technology'
901
+ | 'Finance'
902
+ | 'Healthcare'
903
+ | 'Retail & E-commerce'
904
+ | 'Entertainment'
905
+ | 'Education'
906
+ | 'Government & Nonprofit'
907
+ | 'Industrial & Energy'
908
+ | 'Automotive & Transportation'
909
+ | 'Lifestyle & Leisure'
910
+ | 'Luxury & Fashion'
911
+ | 'News & Media'
912
+ | 'Sports'
913
+ | 'Real Estate & PropTech'
914
+ | 'Legal & Compliance'
915
+ | 'Telecommunications'
916
+ | 'Agriculture & Food'
917
+ | 'Professional Services & Agencies'
918
+ | 'Chemicals & Materials'
919
+ | 'Logistics & Supply Chain'
920
+ | 'Hospitality & Tourism'
921
+ | 'Construction & Built Environment'
922
+ | 'Consumer Packaged Goods (CPG)';
923
+
924
+ /**
925
+ * Subindustry classification enum
926
+ */
927
+ subindustry:
928
+ | 'Defense Systems & Military Hardware'
929
+ | 'Aerospace Manufacturing'
930
+ | 'Avionics & Navigation Technology'
931
+ | 'Subsea & Naval Defense Systems'
932
+ | 'Space & Satellite Technology'
933
+ | 'Defense IT & Systems Integration'
934
+ | 'Software (B2B)'
935
+ | 'Software (B2C)'
936
+ | 'Cloud Infrastructure & DevOps'
937
+ | 'Cybersecurity'
938
+ | 'Artificial Intelligence & Machine Learning'
939
+ | 'Data Infrastructure & Analytics'
940
+ | 'Hardware & Semiconductors'
941
+ | 'Fintech Infrastructure'
942
+ | 'eCommerce & Marketplace Platforms'
943
+ | 'Developer Tools & APIs'
944
+ | 'Web3 & Blockchain'
945
+ | 'XR & Spatial Computing'
946
+ | 'Banking & Lending'
947
+ | 'Investment Management & WealthTech'
948
+ | 'Insurance & InsurTech'
949
+ | 'Payments & Money Movement'
950
+ | 'Accounting, Tax & Financial Planning Tools'
951
+ | 'Capital Markets & Trading Platforms'
952
+ | 'Financial Infrastructure & APIs'
953
+ | 'Credit Scoring & Risk Management'
954
+ | 'Cryptocurrency & Digital Assets'
955
+ | 'BNPL & Alternative Financing'
956
+ | 'Healthcare Providers & Services'
957
+ | 'Pharmaceuticals & Drug Development'
958
+ | 'Medical Devices & Diagnostics'
959
+ | 'Biotechnology & Genomics'
960
+ | 'Digital Health & Telemedicine'
961
+ | 'Health Insurance & Benefits Tech'
962
+ | 'Clinical Trials & Research Platforms'
963
+ | 'Mental Health & Wellness'
964
+ | 'Healthcare IT & EHR Systems'
965
+ | 'Consumer Health & Wellness Products'
966
+ | 'Online Marketplaces'
967
+ | 'Direct-to-Consumer (DTC) Brands'
968
+ | 'Retail Tech & Point-of-Sale Systems'
969
+ | 'Omnichannel & In-Store Retail'
970
+ | 'E-commerce Enablement & Infrastructure'
971
+ | 'Subscription & Membership Commerce'
972
+ | 'Social Commerce & Influencer Platforms'
973
+ | 'Fashion & Apparel Retail'
974
+ | 'Food, Beverage & Grocery E-commerce'
975
+ | 'Streaming Platforms (Video, Music, Audio)'
976
+ | 'Gaming & Interactive Entertainment'
977
+ | 'Creator Economy & Influencer Platforms'
978
+ | 'Advertising, Adtech & Media Buying'
979
+ | 'Film, TV & Production Studios'
980
+ | 'Events, Venues & Live Entertainment'
981
+ | 'Virtual Worlds & Metaverse Experiences'
982
+ | 'K-12 Education Platforms & Tools'
983
+ | 'Higher Education & University Tech'
984
+ | 'Online Learning & MOOCs'
985
+ | 'Test Prep & Certification'
986
+ | 'Corporate Training & Upskilling'
987
+ | 'Tutoring & Supplemental Learning'
988
+ | 'Education Management Systems (LMS/SIS)'
989
+ | 'Language Learning'
990
+ | 'Creator-Led & Cohort-Based Courses'
991
+ | 'Special Education & Accessibility Tools'
992
+ | 'Government Technology & Digital Services'
993
+ | 'Civic Engagement & Policy Platforms'
994
+ | 'International Development & Humanitarian Aid'
995
+ | 'Philanthropy & Grantmaking'
996
+ | 'Nonprofit Operations & Fundraising Tools'
997
+ | 'Public Health & Social Services'
998
+ | 'Education & Youth Development Programs'
999
+ | 'Environmental & Climate Action Organizations'
1000
+ | 'Legal Aid & Social Justice Advocacy'
1001
+ | 'Municipal & Infrastructure Services'
1002
+ | 'Manufacturing & Industrial Automation'
1003
+ | 'Energy Production (Oil, Gas, Nuclear)'
1004
+ | 'Renewable Energy & Cleantech'
1005
+ | 'Utilities & Grid Infrastructure'
1006
+ | 'Industrial IoT & Monitoring Systems'
1007
+ | 'Construction & Heavy Equipment'
1008
+ | 'Mining & Natural Resources'
1009
+ | 'Environmental Engineering & Sustainability'
1010
+ | 'Energy Storage & Battery Technology'
1011
+ | 'Automotive OEMs & Vehicle Manufacturing'
1012
+ | 'Electric Vehicles (EVs) & Charging Infrastructure'
1013
+ | 'Mobility-as-a-Service (MaaS)'
1014
+ | 'Fleet Management'
1015
+ | 'Public Transit & Urban Mobility'
1016
+ | 'Autonomous Vehicles & ADAS'
1017
+ | 'Aftermarket Parts & Services'
1018
+ | 'Telematics & Vehicle Connectivity'
1019
+ | 'Aviation & Aerospace Transport'
1020
+ | 'Maritime Shipping'
1021
+ | 'Fitness & Wellness'
1022
+ | 'Beauty & Personal Care'
1023
+ | 'Home & Living'
1024
+ | 'Dating & Relationships'
1025
+ | 'Hobbies, Crafts & DIY'
1026
+ | 'Outdoor & Recreational Gear'
1027
+ | 'Events, Experiences & Ticketing Platforms'
1028
+ | 'Designer & Luxury Apparel'
1029
+ | 'Accessories, Jewelry & Watches'
1030
+ | 'Footwear & Leather Goods'
1031
+ | 'Beauty, Fragrance & Skincare'
1032
+ | 'Fashion Marketplaces & Retail Platforms'
1033
+ | 'Sustainable & Ethical Fashion'
1034
+ | 'Resale, Vintage & Circular Fashion'
1035
+ | 'Fashion Tech & Virtual Try-Ons'
1036
+ | 'Streetwear & Emerging Luxury'
1037
+ | 'Couture & Made-to-Measure'
1038
+ | 'News Publishing & Journalism'
1039
+ | 'Digital Media & Content Platforms'
1040
+ | 'Broadcasting (TV & Radio)'
1041
+ | 'Podcasting & Audio Media'
1042
+ | 'News Aggregators & Curation Tools'
1043
+ | 'Independent & Creator-Led Media'
1044
+ | 'Newsletters & Substack-Style Platforms'
1045
+ | 'Political & Investigative Media'
1046
+ | 'Trade & Niche Publications'
1047
+ | 'Media Monitoring & Analytics'
1048
+ | 'Professional Teams & Leagues'
1049
+ | 'Sports Media & Broadcasting'
1050
+ | 'Sports Betting & Fantasy Sports'
1051
+ | 'Fitness & Athletic Training Platforms'
1052
+ | 'Sportswear & Equipment'
1053
+ | 'Esports & Competitive Gaming'
1054
+ | 'Sports Venues & Event Management'
1055
+ | 'Athlete Management & Talent Agencies'
1056
+ | 'Sports Tech & Performance Analytics'
1057
+ | 'Youth, Amateur & Collegiate Sports'
1058
+ | 'Real Estate Marketplaces'
1059
+ | 'Property Management Software'
1060
+ | 'Rental Platforms'
1061
+ | 'Mortgage & Lending Tech'
1062
+ | 'Real Estate Investment Platforms'
1063
+ | 'Law Firms & Legal Services'
1064
+ | 'Legal Tech & Automation'
1065
+ | 'Regulatory Compliance'
1066
+ | 'E-Discovery & Litigation Tools'
1067
+ | 'Contract Management'
1068
+ | 'Governance, Risk & Compliance (GRC)'
1069
+ | 'IP & Trademark Management'
1070
+ | 'Legal Research & Intelligence'
1071
+ | 'Compliance Training & Certification'
1072
+ | 'Whistleblower & Ethics Reporting'
1073
+ | 'Mobile & Wireless Networks (3G/4G/5G)'
1074
+ | 'Broadband & Fiber Internet'
1075
+ | 'Satellite & Space-Based Communications'
1076
+ | 'Network Equipment & Infrastructure'
1077
+ | 'Telecom Billing & OSS/BSS Systems'
1078
+ | 'VoIP & Unified Communications'
1079
+ | 'Internet Service Providers (ISPs)'
1080
+ | 'Edge Computing & Network Virtualization'
1081
+ | 'IoT Connectivity Platforms'
1082
+ | 'Precision Agriculture & AgTech'
1083
+ | 'Crop & Livestock Production'
1084
+ | 'Food & Beverage Manufacturing & Processing'
1085
+ | 'Food Distribution'
1086
+ | 'Restaurants & Food Service'
1087
+ | 'Agricultural Inputs & Equipment'
1088
+ | 'Sustainable & Regenerative Agriculture'
1089
+ | 'Seafood & Aquaculture'
1090
+ | 'Management Consulting'
1091
+ | 'Marketing & Advertising Agencies'
1092
+ | 'Design, Branding & Creative Studios'
1093
+ | 'IT Services & Managed Services'
1094
+ | 'Staffing, Recruiting & Talent'
1095
+ | 'Accounting & Tax Firms'
1096
+ | 'Public Relations & Communications'
1097
+ | 'Business Process Outsourcing (BPO)'
1098
+ | 'Professional Training & Coaching'
1099
+ | 'Specialty Chemicals'
1100
+ | 'Commodity & Petrochemicals'
1101
+ | 'Polymers, Plastics & Rubber'
1102
+ | 'Coatings, Adhesives & Sealants'
1103
+ | 'Industrial Gases'
1104
+ | 'Advanced Materials & Composites'
1105
+ | 'Battery Materials & Energy Storage'
1106
+ | 'Electronic Materials & Semiconductor Chemicals'
1107
+ | 'Agrochemicals & Fertilizers'
1108
+ | 'Freight & Transportation Tech'
1109
+ | 'Last-Mile Delivery'
1110
+ | 'Warehouse Automation'
1111
+ | 'Supply Chain Visibility Platforms'
1112
+ | 'Logistics Marketplaces'
1113
+ | 'Shipping & Freight Forwarding'
1114
+ | 'Cold Chain Logistics'
1115
+ | 'Reverse Logistics & Returns'
1116
+ | 'Cross-Border Trade Tech'
1117
+ | 'Transportation Management Systems (TMS)'
1118
+ | 'Hotels & Accommodation'
1119
+ | 'Vacation Rentals & Short-Term Stays'
1120
+ | 'Restaurant Tech & Management'
1121
+ | 'Travel Booking Platforms'
1122
+ | 'Tourism Experiences & Activities'
1123
+ | 'Cruise Lines & Marine Tourism'
1124
+ | 'Hospitality Management Systems'
1125
+ | 'Event & Venue Management'
1126
+ | 'Corporate Travel Management'
1127
+ | 'Travel Insurance & Protection'
1128
+ | 'Construction Management Software'
1129
+ | 'BIM/CAD & Design Tools'
1130
+ | 'Construction Marketplaces'
1131
+ | 'Equipment Rental & Management'
1132
+ | 'Building Materials & Procurement'
1133
+ | 'Construction Workforce Management'
1134
+ | 'Project Estimation & Bidding'
1135
+ | 'Modular & Prefab Construction'
1136
+ | 'Construction Safety & Compliance'
1137
+ | 'Smart Building Technology'
1138
+ | 'Food & Beverage CPG'
1139
+ | 'Home & Personal Care CPG'
1140
+ | 'CPG Analytics & Insights'
1141
+ | 'Direct-to-Consumer CPG Brands'
1142
+ | 'CPG Supply Chain & Distribution'
1143
+ | 'Private Label Manufacturing'
1144
+ | 'CPG Retail Intelligence'
1145
+ | 'Sustainable CPG & Packaging'
1146
+ | 'Beauty & Cosmetics CPG'
1147
+ | 'Health & Wellness CPG';
1148
+ }
1149
+ }
1150
+
611
1151
  export interface Logo {
612
1152
  /**
613
1153
  * Array of colors in the logo
@@ -718,292 +1258,6 @@ export interface BrandPrefetchResponse {
718
1258
  status?: string;
719
1259
  }
720
1260
 
721
- export interface BrandRetrieveByTickerResponse {
722
- /**
723
- * Detailed brand information
724
- */
725
- brand?: BrandRetrieveByTickerResponse.Brand;
726
-
727
- /**
728
- * HTTP status code
729
- */
730
- code?: number;
731
-
732
- /**
733
- * Status of the response, e.g., 'ok'
734
- */
735
- status?: string;
736
- }
737
-
738
- export namespace BrandRetrieveByTickerResponse {
739
- /**
740
- * Detailed brand information
741
- */
742
- export interface Brand {
743
- /**
744
- * Physical address of the brand
745
- */
746
- address?: Brand.Address;
747
-
748
- /**
749
- * An array of backdrop images for the brand
750
- */
751
- backdrops?: Array<Brand.Backdrop>;
752
-
753
- /**
754
- * An array of brand colors
755
- */
756
- colors?: Array<Brand.Color>;
757
-
758
- /**
759
- * A brief description of the brand
760
- */
761
- description?: string;
762
-
763
- /**
764
- * The domain name of the brand
765
- */
766
- domain?: string;
767
-
768
- /**
769
- * Company email address
770
- */
771
- email?: string;
772
-
773
- /**
774
- * Indicates whether the brand content is not safe for work (NSFW)
775
- */
776
- is_nsfw?: boolean;
777
-
778
- /**
779
- * An array of logos associated with the brand
780
- */
781
- logos?: Array<Brand.Logo>;
782
-
783
- /**
784
- * Company phone number
785
- */
786
- phone?: string;
787
-
788
- /**
789
- * The brand's slogan
790
- */
791
- slogan?: string;
792
-
793
- /**
794
- * An array of social media links for the brand
795
- */
796
- socials?: Array<Brand.Social>;
797
-
798
- /**
799
- * Stock market information for this brand (will be null if not a publicly traded
800
- * company)
801
- */
802
- stock?: Brand.Stock;
803
-
804
- /**
805
- * The title or name of the brand
806
- */
807
- title?: string;
808
- }
809
-
810
- export namespace Brand {
811
- /**
812
- * Physical address of the brand
813
- */
814
- export interface Address {
815
- /**
816
- * City name
817
- */
818
- city?: string;
819
-
820
- /**
821
- * Country name
822
- */
823
- country?: string;
824
-
825
- /**
826
- * Country code
827
- */
828
- country_code?: string;
829
-
830
- /**
831
- * Postal or ZIP code
832
- */
833
- postal_code?: string;
834
-
835
- /**
836
- * State or province code
837
- */
838
- state_code?: string;
839
-
840
- /**
841
- * State or province name
842
- */
843
- state_province?: string;
844
-
845
- /**
846
- * Street address
847
- */
848
- street?: string;
849
- }
850
-
851
- export interface Backdrop {
852
- /**
853
- * Array of colors in the backdrop image
854
- */
855
- colors?: Array<Backdrop.Color>;
856
-
857
- /**
858
- * Resolution of the backdrop image
859
- */
860
- resolution?: Backdrop.Resolution;
861
-
862
- /**
863
- * URL of the backdrop image
864
- */
865
- url?: string;
866
- }
867
-
868
- export namespace Backdrop {
869
- export interface Color {
870
- /**
871
- * Color in hexadecimal format
872
- */
873
- hex?: string;
874
-
875
- /**
876
- * Name of the color
877
- */
878
- name?: string;
879
- }
880
-
881
- /**
882
- * Resolution of the backdrop image
883
- */
884
- export interface Resolution {
885
- /**
886
- * Aspect ratio of the image (width/height)
887
- */
888
- aspect_ratio?: number;
889
-
890
- /**
891
- * Height of the image in pixels
892
- */
893
- height?: number;
894
-
895
- /**
896
- * Width of the image in pixels
897
- */
898
- width?: number;
899
- }
900
- }
901
-
902
- export interface Color {
903
- /**
904
- * Color in hexadecimal format
905
- */
906
- hex?: string;
907
-
908
- /**
909
- * Name of the color
910
- */
911
- name?: string;
912
- }
913
-
914
- export interface Logo {
915
- /**
916
- * Array of colors in the logo
917
- */
918
- colors?: Array<Logo.Color>;
919
-
920
- /**
921
- * Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
922
- * best for dark mode, 'has_opaque_background' = can be used for either as image
923
- * has its own background
924
- */
925
- mode?: 'light' | 'dark' | 'has_opaque_background';
926
-
927
- /**
928
- * Resolution of the logo image
929
- */
930
- resolution?: Logo.Resolution;
931
-
932
- /**
933
- * Type of the logo based on resolution (e.g., 'icon', 'logo')
934
- */
935
- type?: 'icon' | 'logo';
936
-
937
- /**
938
- * CDN hosted url of the logo (ready for display)
939
- */
940
- url?: string;
941
- }
942
-
943
- export namespace Logo {
944
- export interface Color {
945
- /**
946
- * Color in hexadecimal format
947
- */
948
- hex?: string;
949
-
950
- /**
951
- * Name of the color
952
- */
953
- name?: string;
954
- }
955
-
956
- /**
957
- * Resolution of the logo image
958
- */
959
- export interface Resolution {
960
- /**
961
- * Aspect ratio of the image (width/height)
962
- */
963
- aspect_ratio?: number;
964
-
965
- /**
966
- * Height of the image in pixels
967
- */
968
- height?: number;
969
-
970
- /**
971
- * Width of the image in pixels
972
- */
973
- width?: number;
974
- }
975
- }
976
-
977
- export interface Social {
978
- /**
979
- * Type of social media, e.g., 'facebook', 'twitter'
980
- */
981
- type?: string;
982
-
983
- /**
984
- * URL of the social media page
985
- */
986
- url?: string;
987
- }
988
-
989
- /**
990
- * Stock market information for this brand (will be null if not a publicly traded
991
- * company)
992
- */
993
- export interface Stock {
994
- /**
995
- * Stock exchange name
996
- */
997
- exchange?: string;
998
-
999
- /**
1000
- * Stock ticker symbol
1001
- */
1002
- ticker?: string;
1003
- }
1004
- }
1005
- }
1006
-
1007
1261
  export interface BrandRetrieveNaicsResponse {
1008
1262
  /**
1009
1263
  * Array of NAICS codes and titles.
@@ -1618,12 +1872,14 @@ export namespace BrandStyleguideResponse {
1618
1872
 
1619
1873
  export interface BrandRetrieveParams {
1620
1874
  /**
1621
- * Domain name to retrieve brand data for
1875
+ * Domain name to retrieve brand data for (e.g., 'example.com', 'google.com').
1876
+ * Cannot be used with name or ticker parameters.
1622
1877
  */
1623
- domain: string;
1878
+ domain?: string;
1624
1879
 
1625
1880
  /**
1626
- * Optional parameter to force the language of the retrieved brand data
1881
+ * Optional parameter to force the language of the retrieved brand data. Works with
1882
+ * all three lookup methods.
1627
1883
  */
1628
1884
  force_language?:
1629
1885
  | 'albanian'
@@ -1682,10 +1938,24 @@ export interface BrandRetrieveParams {
1682
1938
  /**
1683
1939
  * Optional parameter to optimize the API call for maximum speed. When set to true,
1684
1940
  * the API will skip time-consuming operations for faster response at the cost of
1685
- * less comprehensive data.
1941
+ * less comprehensive data. Works with all three lookup methods.
1686
1942
  */
1687
1943
  maxSpeed?: boolean;
1688
1944
 
1945
+ /**
1946
+ * Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
1947
+ * Corporation'). Must be 3-30 characters. Cannot be used with domain or ticker
1948
+ * parameters.
1949
+ */
1950
+ name?: string;
1951
+
1952
+ /**
1953
+ * Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
1954
+ * Must be 1-6 characters, letters/numbers/dots only. Cannot be used with domain or
1955
+ * name parameters.
1956
+ */
1957
+ ticker?: string;
1958
+
1689
1959
  /**
1690
1960
  * Optional timeout in milliseconds for the request. If the request takes longer
1691
1961
  * than this value, it will be aborted with a 408 status code. Maximum allowed
@@ -1815,20 +2085,6 @@ export interface BrandPrefetchParams {
1815
2085
  timeoutMS?: number;
1816
2086
  }
1817
2087
 
1818
- export interface BrandRetrieveByTickerParams {
1819
- /**
1820
- * Stock ticker symbol to retrieve brand data for (e.g. AAPL, TSLA, etc.)
1821
- */
1822
- ticker: string;
1823
-
1824
- /**
1825
- * Optional timeout in milliseconds for the request. If the request takes longer
1826
- * than this value, it will be aborted with a 408 status code. Maximum allowed
1827
- * value is 300000ms (5 minutes).
1828
- */
1829
- timeoutMS?: number;
1830
- }
1831
-
1832
2088
  export interface BrandRetrieveNaicsParams {
1833
2089
  /**
1834
2090
  * Brand domain or title to retrieve NAICS code for. If a valid domain is provided
@@ -1895,7 +2151,6 @@ export declare namespace Brand {
1895
2151
  type BrandAIQueryResponse as BrandAIQueryResponse,
1896
2152
  type BrandIdentifyFromTransactionResponse as BrandIdentifyFromTransactionResponse,
1897
2153
  type BrandPrefetchResponse as BrandPrefetchResponse,
1898
- type BrandRetrieveByTickerResponse as BrandRetrieveByTickerResponse,
1899
2154
  type BrandRetrieveNaicsResponse as BrandRetrieveNaicsResponse,
1900
2155
  type BrandRetrieveSimplifiedResponse as BrandRetrieveSimplifiedResponse,
1901
2156
  type BrandScreenshotResponse as BrandScreenshotResponse,
@@ -1904,7 +2159,6 @@ export declare namespace Brand {
1904
2159
  type BrandAIQueryParams as BrandAIQueryParams,
1905
2160
  type BrandIdentifyFromTransactionParams as BrandIdentifyFromTransactionParams,
1906
2161
  type BrandPrefetchParams as BrandPrefetchParams,
1907
- type BrandRetrieveByTickerParams as BrandRetrieveByTickerParams,
1908
2162
  type BrandRetrieveNaicsParams as BrandRetrieveNaicsParams,
1909
2163
  type BrandRetrieveSimplifiedParams as BrandRetrieveSimplifiedParams,
1910
2164
  type BrandScreenshotParams as BrandScreenshotParams,