@trillboards/cli 0.1.9 → 0.1.10

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @trillboards/cli
 $ trillboards COMMAND
 running command...
 $ trillboards (--version)
-@trillboards/cli/0.1.9 linux-x64 node-v22.23.4
+@trillboards/cli/0.1.10 linux-x64 node-v22.23.4
 $ trillboards --help [COMMAND]
 USAGE
   $ trillboards COMMAND
@@ -599,14 +599,19 @@ One approved metric answered for a day or window, at its grain.
 ```
 USAGE
   $ trillboards generated generated-approved-metric-get METRIC [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
-    [--board_id <value>] [--brands <value>] [--by <value>] [--day <value>] [--daypart <value>] [--dimensions <value>]
-    [--grade <value>] [--grain <value>] [--markets <value>] [--population <value>] [--screens <value>] [--stats <value>]
-    [--window <value>] [--window_end <value>]
+    [--agencies <value>] [--board_id <value>] [--boards <value>] [--brands <value>] [--by <value>] [--categories
+    <value>] [--cbsas <value>] [--day <value>] [--daypart <value>] [--dimensions <value>] [--formats <value>] [--grade
+    <value>] [--grain <value>] [--markets <value>] [--media_owners <value>] [--parents <value>] [--population <value>]
+    [--screens <value>] [--stats <value>] [--surfaces <value>] [--window <value>] [--window_end <value>]
 
 ARGUMENTS
   METRIC  An approved metric name.
 
 FLAGS
+  --agencies=<value>
+      Agency names, |-separated (or repeated): the brands one of them holds as agency of record (Winmo), any case. Taken
+      by: creative_brand_history.
+
   --api-key=<value>
       [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
 
@@ -616,12 +621,22 @@ FLAGS
   --board_id=<value>
       Board face id (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.
 
+  --boards=<value>
+      Face keys, |-separated (or repeated): f:<board id>:<face index> or p:<point id>. Taken by: creative_brand_history.
+
   --brands=<value>
       Comma-separated resolved brand ids. Taken by: creative_brand_history.
 
   --by=<value>
       Condition scope (board metrics): daypart, light, weather or speed. Taken by: board_measured_impressions_per_spot.
 
+  --categories=<value>
+      Comma-separated IAB tier-1 codes (IAB1..IAB25): the brands of those categories. A slice filter narrows the
+      denominators with the rows. Taken by: creative_brand_history.
+
+  --cbsas=<value>
+      Comma-separated 5-digit Census CBSA codes (OMB July 2023 delineation). Taken by: creative_brand_history.
+
   --day=<value>
       One day (YYYY-MM-DD). Give day or window; neither is the last settled day. Taken by: camera_people_per_screen_hour,
       camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, sensing_census,
@@ -633,12 +648,18 @@ FLAGS
       Daypart filter (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.
 
   --dimensions=<value>
-      Comma-separated audience dimensions (dimension= is the one-value spelling). Taken by: demographic_share.
+      Comma-separated dimensions (dimension= is the one-value spelling): the audience dimensions of a demographics metric
+      (default all), or the slices creative_brand_history cuts its rows by (category, parent, agency, media_owner, format,
+      surface, board, cbsa; default none), every share over its slice. Taken by: demographic_share,
+      creative_brand_history.
 
   --format=<option>
       Output format
       <options: json|table|yaml>
 
+  --formats=<value>
+      Comma-separated face formats: static, digital. Taken by: creative_brand_history.
+
   --grade=<value>
       Camera evidence grade: face_backed or person_backed. Taken by: camera_people_per_screen_hour,
       camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct.
@@ -655,6 +676,14 @@ FLAGS
       creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance,
       seatbelt_unbuckled_ride_rate.
 
+  --media_owners=<value>
+      Media owner names, |-separated (or repeated): the faces whose registry owner holds a name's letters and digits, any
+      case and punctuation. Taken by: creative_brand_history.
+
+  --parents=<value>
+      Comma-separated brand graph ids: the brands whose parent company is in one of those Wikidata families. Taken by:
+      creative_brand_history.
+
   --population=<value>
       The population the shares are over. Taken by: sensing_census, same_panel_index.
 
@@ -667,6 +696,9 @@ FLAGS
       Comma-separated statistics (mean, p50, ...), from the metric's allowed stats. Taken by:
       camera_people_per_screen_hour, camera_head_pose_index.
 
+  --surfaces=<value>
+      Comma-separated reader surfaces: billboard, digital_board, bus_shelter, kiosk. Taken by: creative_brand_history.
+
   --window=<value>
       An inclusive span, YYYY-MM-DD..YYYY-MM-DD, up to the metric's max_window_days. Taken by:
       camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share,
@@ -1056,28 +1088,34 @@ Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo
 
 ```
 USAGE
-  $ trillboards generated generated-data-api-ad-sightings [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--brand <value>]
-    [--brand_id <value>] [--market <value>] [--surface <value>] [--board_id <value>] [--creative_id <value>]
-    [--instrument <value>] [--from <value>] [--to <value>] [--limit <value>] [--cursor <value>]
+  $ trillboards generated generated-data-api-ad-sightings [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--brand
+    <value>...] [--brand_id <value>...] [--market <value>...] [--surface <value>...] [--board_id <value>...]
+    [--creative_id <value>...] [--instrument <value>...] [--category <value>...] [--media_owner <value>...] [--from
+    <value>] [--to <value>] [--limit <value>] [--cursor <value>]
 
 FLAGS
-  --api-key=<value>      [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
-  --base-url=<value>     [default: https://api.trillboards.com] API base URL
-  --board_id=<value>     A board the sighting was matched to, repeatable.
-  --brand=<value>        A brand, repeatable for a brand set (competitors). Matched however it is typed: "McDonald's",
-                         "mcdonalds" and "Mc Donalds" find the same records.
-  --brand_id=<value>     A resolved brand id, repeatable. Combined with `brand` as either-or.
-  --creative_id=<value>  A sighted creative (the campaign artwork), repeatable.
-  --cursor=<value>       The `next_cursor` of the previous page.
-  --format=<option>      Output format
-                         <options: json|table|yaml>
-  --from=<value>         Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.
-  --instrument=<value>   The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.
-  --limit=<value>        Records per page, 1..500 (default 50). The page limit is reserved; the records returned are
-                         billed.
-  --market=<value>       A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.
-  --surface=<value>      The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.
-  --to=<value>           End (exclusive). Default: now. The span is at most 400 days.
+  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>        [default: https://api.trillboards.com] API base URL
+  --board_id=<value>...     A board the sighting was matched to, repeatable.
+  --brand=<value>...        A brand, repeatable for a brand set (competitors). Matched however it is typed:
+                            "McDonald's", "mcdonalds" and "Mc Donalds" find the same records.
+  --brand_id=<value>...     A resolved brand id, repeatable. Combined with `brand` as either-or.
+  --category=<value>...     The brand's IAB tier-1 category (IAB1..IAB25), repeatable: the records whose resolved brand
+                            votes in it (brand_knowledge_graph.iab_category, the `category` field).
+  --creative_id=<value>...  A sighted creative (the campaign artwork), repeatable.
+  --cursor=<value>          The `next_cursor` of the previous page.
+  --format=<option>         Output format
+                            <options: json|table|yaml>
+  --from=<value>            Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.
+  --instrument=<value>...   The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.
+  --limit=<value>           Records per page, 1..500 (default 50). The page limit is reserved; the records returned are
+                            billed.
+  --market=<value>...       A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.
+  --media_owner=<value>...  A media owner, repeatable: the records matched to a face whose owner (`publisher_name`, the
+                            registry's) holds the name's letters and digits, any case and punctuation (Lamar finds
+                            LAMAR-PITTSBURGH and Lamar (Cincinnati)).
+  --surface=<value>...      The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.
+  --to=<value>              End (exclusive). Default: now. The span is at most 400 days.
 
 DESCRIPTION
   Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo link.
@@ -1092,23 +1130,46 @@ Outdoor creative history by brand, market and month, from the creative ledger.
 
 ```
 USAGE
-  $ trillboards generated generated-data-api-ad-sightings-history [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--brand <value>]
-    [--brand_id <value>] [--market <value>] [--from <value>] [--to <value>] [--grain <value>] [--limit <value>]
-    [--cursor <value>]
+  $ trillboards generated generated-data-api-ad-sightings-history [--api-key <value>] [--base-url <value>] [--format <value>...] [--brand <value>...]
+    [--brand_id <value>...] [--market <value>...] [--from <value>] [--to <value>] [--grain <value>] [--dimension
+    <value>...] [--category <value>...] [--parent <value>...] [--agency <value>...] [--media_owner <value>...]
+    [--surface <value>...] [--board <value>...] [--cbsa <value>...] [--limit <value>] [--cursor <value>]
 
 FLAGS
-  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
-  --base-url=<value>  [default: https://api.trillboards.com] API base URL
-  --brand=<value>     A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.
-  --brand_id=<value>  A resolved brand id, repeatable.
-  --cursor=<value>    The `next_cursor` of the previous page.
-  --format=<option>   Output format
-                      <options: json|table|yaml>
-  --from=<value>      First month (YYYY-MM) or day. Default: 12 months before `to`.
-  --grain=<value>     market_month (default) or fleet_month.
-  --limit=<value>     Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are billed.
-  --market=<value>    A market as COUNTRY:CODE, repeatable.
-  --to=<value>        Last month (YYYY-MM, inclusive) or day. Default: this month.
+  --agency=<value>...       Narrow to brands this agency holds as agency of record (Winmo), by name in any case,
+                            repeatable.
+  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>        [default: https://api.trillboards.com] API base URL
+  --board=<value>...        Narrow to faces by face key, repeatable for a set of boards: f:<board id>:<face index> (a
+                            registered face) or p:<point id> (an unregistered board point), the `face_key` a board slice
+                            answers with.
+  --brand=<value>...        A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search
+                            does.
+  --brand_id=<value>...     A resolved brand id, repeatable.
+  --category=<value>...     Narrow to brands of an IAB tier-1 category (IAB1..IAB25), repeatable. A slice filter narrows
+                            the denominators with the rows: the shares are within the categories named.
+  --cbsa=<value>...         Narrow to faces in a Census CBSA (5-digit code, OMB July 2023 delineation), repeatable.
+  --cursor=<value>          The `next_cursor` of the previous page.
+  --dimension=<value>...    A slice the rows are cut by, repeatable: category, parent, agency (what the brand is),
+                            media_owner, format, surface, board, cbsa (where it ran). Each row is a brand within its
+                            slice, and every share is over its slice: a slice recomputes every denominator, and every
+                            distinct count is counted within it. The market vacancy is cut by where-it-ran slices only.
+  --format=<value>...       Narrow to static or digital faces, repeatable.
+  --from=<value>            First month (YYYY-MM) or day. Default: 12 months before `to`.
+  --grain=<value>           market_month (default) or fleet_month; market_week or fleet_week (ISO weeks from their
+                            Monday, each counted whole, every week the from..to span touches); market_window or
+                            fleet_window (the from..to span as one period). A fleet grain drops the market: with
+                            dimension=cbsa it is the CBSA geography.
+  --limit=<value>           Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are
+                            billed.
+  --market=<value>...       A market as COUNTRY:CODE, repeatable.
+  --media_owner=<value>...  Narrow to faces whose registry owner holds the name's letters and digits, any case and
+                            punctuation (Lamar finds LAMAR-PITTSBURGH and Lamar (Cincinnati)), repeatable.
+  --parent=<value>...       Narrow to brands whose parent company is in this brand graph id's family (the `parent_id` a
+                            parent slice answers with), repeatable.
+  --surface=<value>...      Narrow to faces of a reader surface (billboard, digital_board, bus_shelter, kiosk),
+                            repeatable.
+  --to=<value>              Last month (YYYY-MM, inclusive) or day. Default: this month.
 
 DESCRIPTION
   Outdoor creative history by brand, market and month, from the creative ledger.

package/dist/commands/generated/generated-approved-metric-get.d.ts

@@ -6,18 +6,26 @@ export default class Getapprovedmetric extends BaseCommand {
         metric: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        agencies: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         board_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        boards: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         brands: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         by: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        categories: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cbsas: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         day: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         daypart: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         dimensions: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        formats: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         grade: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         grain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         markets: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        media_owners: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        parents: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         population: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         screens: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         stats: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        surfaces: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         window: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         window_end: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/generated/generated-approved-metric-get.js

@@ -12,18 +12,26 @@ export default class Getapprovedmetric extends BaseCommand {
     };
     static flags = {
         ...BaseCommand.baseFlags,
+        'agencies': Flags.string({ description: 'Agency names, |-separated (or repeated): the brands one of them holds as agency of record (Winmo), any case. Taken by: creative_brand_history.' }),
         'board_id': Flags.string({ description: 'Board face id (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.' }),
+        'boards': Flags.string({ description: 'Face keys, |-separated (or repeated): f:<board id>:<face index> or p:<point id>. Taken by: creative_brand_history.' }),
         'brands': Flags.string({ description: 'Comma-separated resolved brand ids. Taken by: creative_brand_history.' }),
         'by': Flags.string({ description: 'Condition scope (board metrics): daypart, light, weather or speed. Taken by: board_measured_impressions_per_spot.' }),
+        'categories': Flags.string({ description: 'Comma-separated IAB tier-1 codes (IAB1..IAB25): the brands of those categories. A slice filter narrows the denominators with the rows. Taken by: creative_brand_history.' }),
+        'cbsas': Flags.string({ description: 'Comma-separated 5-digit Census CBSA codes (OMB July 2023 delineation). Taken by: creative_brand_history.' }),
         'day': Flags.string({ description: 'One day (YYYY-MM-DD). Give day or window; neither is the last settled day. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, sensing_census, same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance, seatbelt_unbuckled_ride_rate.' }),
         'daypart': Flags.string({ description: 'Daypart filter (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.' }),
-        'dimensions': Flags.string({ description: 'Comma-separated audience dimensions (dimension= is the one-value spelling). Taken by: demographic_share.' }),
+        'dimensions': Flags.string({ description: 'Comma-separated dimensions (dimension= is the one-value spelling): the audience dimensions of a demographics metric (default all), or the slices creative_brand_history cuts its rows by (category, parent, agency, media_owner, format, surface, board, cbsa; default none), every share over its slice. Taken by: demographic_share, creative_brand_history.' }),
+        'formats': Flags.string({ description: 'Comma-separated face formats: static, digital. Taken by: creative_brand_history.' }),
         'grade': Flags.string({ description: 'Camera evidence grade: face_backed or person_backed. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct.' }),
         'grain': Flags.string({ description: 'The answer grain (screen_hour, screen_day, fleet_day, market_day, market_month, ...): one of the metric\'s grains. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, sensing_census, same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance, seatbelt_unbuckled_ride_rate.' }),
         'markets': Flags.string({ description: 'Comma-separated markets as COUNTRY:CODE (US DMA, CA CMA). Taken by: creative_sightings, creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance, seatbelt_unbuckled_ride_rate.' }),
+        'media_owners': Flags.string({ description: 'Media owner names, |-separated (or repeated): the faces whose registry owner holds a name\'s letters and digits, any case and punctuation. Taken by: creative_brand_history.' }),
+        'parents': Flags.string({ description: 'Comma-separated brand graph ids: the brands whose parent company is in one of those Wikidata families. Taken by: creative_brand_history.' }),
         'population': Flags.string({ description: 'The population the shares are over. Taken by: sensing_census, same_panel_index.' }),
         'screens': Flags.string({ description: 'Comma-separated 24-hex screen ids, up to the metric\'s max_screens. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, seatbelt_compliance, seatbelt_unbuckled_ride_rate.' }),
         'stats': Flags.string({ description: 'Comma-separated statistics (mean, p50, ...), from the metric\'s allowed stats. Taken by: camera_people_per_screen_hour, camera_head_pose_index.' }),
+        'surfaces': Flags.string({ description: 'Comma-separated reader surfaces: billboard, digital_board, bus_shelter, kiosk. Taken by: creative_brand_history.' }),
         'window': Flags.string({ description: 'An inclusive span, YYYY-MM-DD..YYYY-MM-DD, up to the metric\'s max_window_days. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance, seatbelt_unbuckled_ride_rate.' }),
         'window_end': Flags.string({ description: 'Currency window end (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.' }),
     };
@@ -36,30 +44,46 @@ export default class Getapprovedmetric extends BaseCommand {
         let urlPath = '/v1/advertiser/measurement/metrics/{metric}';
         urlPath = urlPath.replace('{metric}', args['metric']);
         const params = {};
+        if (flags['agencies'])
+            params['agencies'] = flags['agencies'];
         if (flags['board_id'])
             params['board_id'] = flags['board_id'];
+        if (flags['boards'])
+            params['boards'] = flags['boards'];
         if (flags['brands'])
             params['brands'] = flags['brands'];
         if (flags['by'])
             params['by'] = flags['by'];
+        if (flags['categories'])
+            params['categories'] = flags['categories'];
+        if (flags['cbsas'])
+            params['cbsas'] = flags['cbsas'];
         if (flags['day'])
             params['day'] = flags['day'];
         if (flags['daypart'])
             params['daypart'] = flags['daypart'];
         if (flags['dimensions'])
             params['dimensions'] = flags['dimensions'];
+        if (flags['formats'])
+            params['formats'] = flags['formats'];
         if (flags['grade'])
             params['grade'] = flags['grade'];
         if (flags['grain'])
             params['grain'] = flags['grain'];
         if (flags['markets'])
             params['markets'] = flags['markets'];
+        if (flags['media_owners'])
+            params['media_owners'] = flags['media_owners'];
+        if (flags['parents'])
+            params['parents'] = flags['parents'];
         if (flags['population'])
             params['population'] = flags['population'];
         if (flags['screens'])
             params['screens'] = flags['screens'];
         if (flags['stats'])
             params['stats'] = flags['stats'];
+        if (flags['surfaces'])
+            params['surfaces'] = flags['surfaces'];
         if (flags['window'])
             params['window'] = flags['window'];
         if (flags['window_end'])

package/dist/commands/generated/generated-data-api-ad-sightings-history.d.ts

@@ -4,17 +4,25 @@ export default class Dataapiadsightingshistory extends BaseCommand {
     static examples: string[];
     static args: {};
     static flags: {
-        brand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        brand_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        market: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        brand: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        brand_id: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        market: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         grain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dimension: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        category: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        parent: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        agency: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        media_owner: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        surface: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        board: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cbsa: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         cursor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/generated/generated-data-api-ad-sightings-history.js

@@ -10,12 +10,21 @@ export default class Dataapiadsightingshistory extends BaseCommand {
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
-        'brand': Flags.string({ description: 'A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.' }),
-        'brand_id': Flags.string({ description: 'A resolved brand id, repeatable.' }),
-        'market': Flags.string({ description: 'A market as COUNTRY:CODE, repeatable.' }),
+        'brand': Flags.string({ description: 'A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.', multiple: true }),
+        'brand_id': Flags.string({ description: 'A resolved brand id, repeatable.', multiple: true }),
+        'market': Flags.string({ description: 'A market as COUNTRY:CODE, repeatable.', multiple: true }),
         'from': Flags.string({ description: 'First month (YYYY-MM) or day. Default: 12 months before `to`.' }),
         'to': Flags.string({ description: 'Last month (YYYY-MM, inclusive) or day. Default: this month.' }),
-        'grain': Flags.string({ description: 'market_month (default) or fleet_month.' }),
+        'grain': Flags.string({ description: 'market_month (default) or fleet_month; market_week or fleet_week (ISO weeks from their Monday, each counted whole, every week the from..to span touches); market_window or fleet_window (the from..to span as one period). A fleet grain drops the market: with dimension=cbsa it is the CBSA geography.' }),
+        'dimension': Flags.string({ description: 'A slice the rows are cut by, repeatable: category, parent, agency (what the brand is), media_owner, format, surface, board, cbsa (where it ran). Each row is a brand within its slice, and every share is over its slice: a slice recomputes every denominator, and every distinct count is counted within it. The market vacancy is cut by where-it-ran slices only.', multiple: true }),
+        'category': Flags.string({ description: 'Narrow to brands of an IAB tier-1 category (IAB1..IAB25), repeatable. A slice filter narrows the denominators with the rows: the shares are within the categories named.', multiple: true }),
+        'parent': Flags.string({ description: 'Narrow to brands whose parent company is in this brand graph id\'s family (the `parent_id` a parent slice answers with), repeatable.', multiple: true }),
+        'agency': Flags.string({ description: 'Narrow to brands this agency holds as agency of record (Winmo), by name in any case, repeatable.', multiple: true }),
+        'media_owner': Flags.string({ description: 'Narrow to faces whose registry owner holds the name\'s letters and digits, any case and punctuation (Lamar finds LAMAR-PITTSBURGH and Lamar (Cincinnati)), repeatable.', multiple: true }),
+        'format': Flags.string({ description: 'Narrow to static or digital faces, repeatable.', multiple: true }),
+        'surface': Flags.string({ description: 'Narrow to faces of a reader surface (billboard, digital_board, bus_shelter, kiosk), repeatable.', multiple: true }),
+        'board': Flags.string({ description: 'Narrow to faces by face key, repeatable for a set of boards: f:<board id>:<face index> (a registered face) or p:<point id> (an unregistered board point), the `face_key` a board slice answers with.', multiple: true }),
+        'cbsa': Flags.string({ description: 'Narrow to faces in a Census CBSA (5-digit code, OMB July 2023 delineation), repeatable.', multiple: true }),
         'limit': Flags.string({ description: 'Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are billed.' }),
         'cursor': Flags.string({ description: 'The `next_cursor` of the previous page.' }),
     };
@@ -27,11 +36,11 @@ export default class Dataapiadsightingshistory extends BaseCommand {
             this.error('Not logged in. Run: trillboards login');
         let urlPath = '/v1/data/ad-sightings/history';
         const params = {};
-        if (flags['brand'])
+        if (flags['brand'] && flags['brand'].length > 0)
             params['brand'] = flags['brand'];
-        if (flags['brand_id'])
+        if (flags['brand_id'] && flags['brand_id'].length > 0)
             params['brand_id'] = flags['brand_id'];
-        if (flags['market'])
+        if (flags['market'] && flags['market'].length > 0)
             params['market'] = flags['market'];
         if (flags['from'])
             params['from'] = flags['from'];
@@ -39,6 +48,24 @@ export default class Dataapiadsightingshistory extends BaseCommand {
             params['to'] = flags['to'];
         if (flags['grain'])
             params['grain'] = flags['grain'];
+        if (flags['dimension'] && flags['dimension'].length > 0)
+            params['dimension'] = flags['dimension'];
+        if (flags['category'] && flags['category'].length > 0)
+            params['category'] = flags['category'];
+        if (flags['parent'] && flags['parent'].length > 0)
+            params['parent'] = flags['parent'];
+        if (flags['agency'] && flags['agency'].length > 0)
+            params['agency'] = flags['agency'];
+        if (flags['media_owner'] && flags['media_owner'].length > 0)
+            params['media_owner'] = flags['media_owner'];
+        if (flags['format'] && flags['format'].length > 0)
+            params['format'] = flags['format'];
+        if (flags['surface'] && flags['surface'].length > 0)
+            params['surface'] = flags['surface'];
+        if (flags['board'] && flags['board'].length > 0)
+            params['board'] = flags['board'];
+        if (flags['cbsa'] && flags['cbsa'].length > 0)
+            params['cbsa'] = flags['cbsa'];
         if (flags['limit'])
             params['limit'] = flags['limit'];
         if (flags['cursor'])

package/dist/commands/generated/generated-data-api-ad-sightings.d.ts

@@ -4,13 +4,15 @@ export default class Dataapiadsightings extends BaseCommand {
     static examples: string[];
     static args: {};
     static flags: {
-        brand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        brand_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        market: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        surface: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        board_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        creative_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        instrument: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        brand: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        brand_id: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        market: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        surface: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        board_id: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        creative_id: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instrument: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        category: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        media_owner: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/generated/generated-data-api-ad-sightings.js

@@ -10,13 +10,15 @@ export default class Dataapiadsightings extends BaseCommand {
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
-        'brand': Flags.string({ description: 'A brand, repeatable for a brand set (competitors). Matched however it is typed: "McDonald\'s", "mcdonalds" and "Mc Donalds" find the same records.' }),
-        'brand_id': Flags.string({ description: 'A resolved brand id, repeatable. Combined with `brand` as either-or.' }),
-        'market': Flags.string({ description: 'A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.' }),
-        'surface': Flags.string({ description: 'The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.' }),
-        'board_id': Flags.string({ description: 'A board the sighting was matched to, repeatable.' }),
-        'creative_id': Flags.string({ description: 'A sighted creative (the campaign artwork), repeatable.' }),
-        'instrument': Flags.string({ description: 'The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.' }),
+        'brand': Flags.string({ description: 'A brand, repeatable for a brand set (competitors). Matched however it is typed: "McDonald\'s", "mcdonalds" and "Mc Donalds" find the same records.', multiple: true }),
+        'brand_id': Flags.string({ description: 'A resolved brand id, repeatable. Combined with `brand` as either-or.', multiple: true }),
+        'market': Flags.string({ description: 'A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.', multiple: true }),
+        'surface': Flags.string({ description: 'The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.', multiple: true }),
+        'board_id': Flags.string({ description: 'A board the sighting was matched to, repeatable.', multiple: true }),
+        'creative_id': Flags.string({ description: 'A sighted creative (the campaign artwork), repeatable.', multiple: true }),
+        'instrument': Flags.string({ description: 'The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.', multiple: true }),
+        'category': Flags.string({ description: 'The brand\'s IAB tier-1 category (IAB1..IAB25), repeatable: the records whose resolved brand votes in it (brand_knowledge_graph.iab_category, the `category` field).', multiple: true }),
+        'media_owner': Flags.string({ description: 'A media owner, repeatable: the records matched to a face whose owner (`publisher_name`, the registry\'s) holds the name\'s letters and digits, any case and punctuation (Lamar finds LAMAR-PITTSBURGH and Lamar (Cincinnati)).', multiple: true }),
         'from': Flags.string({ description: 'Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.' }),
         'to': Flags.string({ description: 'End (exclusive). Default: now. The span is at most 400 days.' }),
         'limit': Flags.string({ description: 'Records per page, 1..500 (default 50). The page limit is reserved; the records returned are billed.' }),
@@ -30,20 +32,24 @@ export default class Dataapiadsightings extends BaseCommand {
             this.error('Not logged in. Run: trillboards login');
         let urlPath = '/v1/data/ad-sightings';
         const params = {};
-        if (flags['brand'])
+        if (flags['brand'] && flags['brand'].length > 0)
             params['brand'] = flags['brand'];
-        if (flags['brand_id'])
+        if (flags['brand_id'] && flags['brand_id'].length > 0)
             params['brand_id'] = flags['brand_id'];
-        if (flags['market'])
+        if (flags['market'] && flags['market'].length > 0)
             params['market'] = flags['market'];
-        if (flags['surface'])
+        if (flags['surface'] && flags['surface'].length > 0)
             params['surface'] = flags['surface'];
-        if (flags['board_id'])
+        if (flags['board_id'] && flags['board_id'].length > 0)
             params['board_id'] = flags['board_id'];
-        if (flags['creative_id'])
+        if (flags['creative_id'] && flags['creative_id'].length > 0)
             params['creative_id'] = flags['creative_id'];
-        if (flags['instrument'])
+        if (flags['instrument'] && flags['instrument'].length > 0)
             params['instrument'] = flags['instrument'];
+        if (flags['category'] && flags['category'].length > 0)
+            params['category'] = flags['category'];
+        if (flags['media_owner'] && flags['media_owner'].length > 0)
+            params['media_owner'] = flags['media_owner'];
         if (flags['from'])
             params['from'] = flags['from'];
         if (flags['to'])

package/dist/http.d.ts

@@ -15,6 +15,7 @@ export interface ApiRequestOptions {
     token?: string;
     baseUrl: string;
     body?: unknown;
-    params?: Record<string, string>;
+    /** Query parameters; a list is sent once per value (?board=a&board=b). */
+    params?: Record<string, string | string[]>;
 }
 export declare function apiRequest(method: string, path: string, options: ApiRequestOptions): Promise<unknown>;

package/dist/http.js

@@ -20,7 +20,13 @@ export async function apiRequest(method, path, options) {
     const url = new URL(path, options.baseUrl);
     if (options.params) {
         for (const [k, v] of Object.entries(options.params)) {
-            url.searchParams.set(k, v);
+            if (Array.isArray(v)) {
+                for (const each of v)
+                    url.searchParams.append(k, each);
+            }
+            else {
+                url.searchParams.set(k, v);
+            }
         }
     }
     const headers = {

package/oclif.manifest.json

@@ -1442,6 +1442,13 @@
           ],
           "type": "option"
         },
+        "agencies": {
+          "description": "Agency names, |-separated (or repeated): the brands one of them holds as agency of record (Winmo), any case. Taken by: creative_brand_history.",
+          "name": "agencies",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "board_id": {
           "description": "Board face id (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.",
           "name": "board_id",
@@ -1449,6 +1456,13 @@
           "multiple": false,
           "type": "option"
         },
+        "boards": {
+          "description": "Face keys, |-separated (or repeated): f:<board id>:<face index> or p:<point id>. Taken by: creative_brand_history.",
+          "name": "boards",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "brands": {
           "description": "Comma-separated resolved brand ids. Taken by: creative_brand_history.",
           "name": "brands",
@@ -1463,6 +1477,20 @@
           "multiple": false,
           "type": "option"
         },
+        "categories": {
+          "description": "Comma-separated IAB tier-1 codes (IAB1..IAB25): the brands of those categories. A slice filter narrows the denominators with the rows. Taken by: creative_brand_history.",
+          "name": "categories",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cbsas": {
+          "description": "Comma-separated 5-digit Census CBSA codes (OMB July 2023 delineation). Taken by: creative_brand_history.",
+          "name": "cbsas",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "day": {
           "description": "One day (YYYY-MM-DD). Give day or window; neither is the last settled day. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, sensing_census, same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance, seatbelt_unbuckled_ride_rate.",
           "name": "day",
@@ -1478,12 +1506,19 @@
           "type": "option"
         },
         "dimensions": {
-          "description": "Comma-separated audience dimensions (dimension= is the one-value spelling). Taken by: demographic_share.",
+          "description": "Comma-separated dimensions (dimension= is the one-value spelling): the audience dimensions of a demographics metric (default all), or the slices creative_brand_history cuts its rows by (category, parent, agency, media_owner, format, surface, board, cbsa; default none), every share over its slice. Taken by: demographic_share, creative_brand_history.",
           "name": "dimensions",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "formats": {
+          "description": "Comma-separated face formats: static, digital. Taken by: creative_brand_history.",
+          "name": "formats",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "grade": {
           "description": "Camera evidence grade: face_backed or person_backed. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct.",
           "name": "grade",
@@ -1505,6 +1540,20 @@
           "multiple": false,
           "type": "option"
         },
+        "media_owners": {
+          "description": "Media owner names, |-separated (or repeated): the faces whose registry owner holds a name's letters and digits, any case and punctuation. Taken by: creative_brand_history.",
+          "name": "media_owners",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "parents": {
+          "description": "Comma-separated brand graph ids: the brands whose parent company is in one of those Wikidata families. Taken by: creative_brand_history.",
+          "name": "parents",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "population": {
           "description": "The population the shares are over. Taken by: sensing_census, same_panel_index.",
           "name": "population",
@@ -1526,6 +1575,13 @@
           "multiple": false,
           "type": "option"
         },
+        "surfaces": {
+          "description": "Comma-separated reader surfaces: billboard, digital_board, bus_shelter, kiosk. Taken by: creative_brand_history.",
+          "name": "surfaces",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "window": {
           "description": "An inclusive span, YYYY-MM-DD..YYYY-MM-DD, up to the metric's max_window_days. Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance, seatbelt_unbuckled_ride_rate.",
           "name": "window",
@@ -2531,36 +2587,31 @@
           "type": "option"
         },
         "format": {
-          "description": "Output format",
+          "description": "Narrow to static or digital faces, repeatable.",
           "name": "format",
           "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "json",
-            "table",
-            "yaml"
-          ],
+          "multiple": true,
           "type": "option"
         },
         "brand": {
           "description": "A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.",
           "name": "brand",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "brand_id": {
           "description": "A resolved brand id, repeatable.",
           "name": "brand_id",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "market": {
           "description": "A market as COUNTRY:CODE, repeatable.",
           "name": "market",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "from": {
@@ -2578,12 +2629,68 @@
           "type": "option"
         },
         "grain": {
-          "description": "market_month (default) or fleet_month.",
+          "description": "market_month (default) or fleet_month; market_week or fleet_week (ISO weeks from their Monday, each counted whole, every week the from..to span touches); market_window or fleet_window (the from..to span as one period). A fleet grain drops the market: with dimension=cbsa it is the CBSA geography.",
           "name": "grain",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "dimension": {
+          "description": "A slice the rows are cut by, repeatable: category, parent, agency (what the brand is), media_owner, format, surface, board, cbsa (where it ran). Each row is a brand within its slice, and every share is over its slice: a slice recomputes every denominator, and every distinct count is counted within it. The market vacancy is cut by where-it-ran slices only.",
+          "name": "dimension",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "category": {
+          "description": "Narrow to brands of an IAB tier-1 category (IAB1..IAB25), repeatable. A slice filter narrows the denominators with the rows: the shares are within the categories named.",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "parent": {
+          "description": "Narrow to brands whose parent company is in this brand graph id's family (the `parent_id` a parent slice answers with), repeatable.",
+          "name": "parent",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "agency": {
+          "description": "Narrow to brands this agency holds as agency of record (Winmo), by name in any case, repeatable.",
+          "name": "agency",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "media_owner": {
+          "description": "Narrow to faces whose registry owner holds the name's letters and digits, any case and punctuation (Lamar finds LAMAR-PITTSBURGH and Lamar (Cincinnati)), repeatable.",
+          "name": "media_owner",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "surface": {
+          "description": "Narrow to faces of a reader surface (billboard, digital_board, bus_shelter, kiosk), repeatable.",
+          "name": "surface",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "board": {
+          "description": "Narrow to faces by face key, repeatable for a set of boards: f:<board id>:<face index> (a registered face) or p:<point id> (an unregistered board point), the `face_key` a board slice answers with.",
+          "name": "board",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "cbsa": {
+          "description": "Narrow to faces in a Census CBSA (5-digit code, OMB July 2023 delineation), repeatable.",
+          "name": "cbsa",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "limit": {
           "description": "Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are billed.",
           "name": "limit",
@@ -2655,49 +2762,63 @@
           "description": "A brand, repeatable for a brand set (competitors). Matched however it is typed: \"McDonald's\", \"mcdonalds\" and \"Mc Donalds\" find the same records.",
           "name": "brand",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "brand_id": {
           "description": "A resolved brand id, repeatable. Combined with `brand` as either-or.",
           "name": "brand_id",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "market": {
           "description": "A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.",
           "name": "market",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "surface": {
           "description": "The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.",
           "name": "surface",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "board_id": {
           "description": "A board the sighting was matched to, repeatable.",
           "name": "board_id",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "creative_id": {
           "description": "A sighted creative (the campaign artwork), repeatable.",
           "name": "creative_id",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "instrument": {
           "description": "The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.",
           "name": "instrument",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "category": {
+          "description": "The brand's IAB tier-1 category (IAB1..IAB25), repeatable: the records whose resolved brand votes in it (brand_knowledge_graph.iab_category, the `category` field).",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "media_owner": {
+          "description": "A media owner, repeatable: the records matched to a face whose owner (`publisher_name`, the registry's) holds the name's letters and digits, any case and punctuation (Lamar finds LAMAR-PITTSBURGH and Lamar (Cincinnati)).",
+          "name": "media_owner",
+          "hasDynamicHelp": false,
+          "multiple": true,
           "type": "option"
         },
         "from": {
@@ -6776,13 +6897,15 @@
         "tail.js"
       ]
     },
-    "sandbox:create": {
+    "screens:watch": {
       "aliases": [],
       "args": {},
-      "description": "Create a sandbox test screen",
+      "description": "Live fleet dashboard — watch all screens in real-time",
       "examples": [
-        "<%= config.bin %> sandbox create",
-        "<%= config.bin %> sandbox create --format json"
+        "<%= config.bin %> screens watch",
+        "<%= config.bin %> screens watch --filter online",
+        "<%= config.bin %> screens watch --sort earnings",
+        "<%= config.bin %> screens watch --format json"
       ],
       "flags": {
         "api-key": {
@@ -6812,11 +6935,43 @@
             "yaml"
           ],
           "type": "option"
+        },
+        "filter": {
+          "description": "Filter screens by status",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "online",
+            "offline"
+          ],
+          "type": "option"
+        },
+        "interval": {
+          "description": "Refresh interval in seconds",
+          "name": "interval",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort column",
+          "name": "sort",
+          "default": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "name",
+            "earnings",
+            "fill-rate"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sandbox:create",
+      "id": "screens:watch",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -6826,24 +6981,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "sandbox",
-        "create.js"
+        "screens",
+        "watch.js"
       ]
     },
-    "sandbox:emit": {
+    "sandbox:create": {
       "aliases": [],
-      "args": {
-        "event_type": {
-          "description": "Event type to emit (e.g. impression.recorded, heartbeat)",
-          "name": "event_type",
-          "required": true
-        }
-      },
-      "description": "Emit a test event in the sandbox",
+      "args": {},
+      "description": "Create a sandbox test screen",
       "examples": [
-        "<%= config.bin %> sandbox emit impression.recorded",
-        "<%= config.bin %> sandbox emit heartbeat",
-        "<%= config.bin %> sandbox emit impression.recorded --data '{\"cpm\": 3.50}'"
+        "<%= config.bin %> sandbox create",
+        "<%= config.bin %> sandbox create --format json"
       ],
       "flags": {
         "api-key": {
@@ -6873,19 +7021,11 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "data": {
-          "char": "d",
-          "description": "Additional event data (JSON string)",
-          "name": "data",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sandbox:emit",
+      "id": "sandbox:create",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -6896,16 +7036,23 @@
         "dist",
         "commands",
         "sandbox",
-        "emit.js"
+        "create.js"
       ]
     },
-    "sandbox:reset": {
+    "sandbox:emit": {
       "aliases": [],
-      "args": {},
-      "description": "Reset the sandbox — delete all test screens and events",
+      "args": {
+        "event_type": {
+          "description": "Event type to emit (e.g. impression.recorded, heartbeat)",
+          "name": "event_type",
+          "required": true
+        }
+      },
+      "description": "Emit a test event in the sandbox",
       "examples": [
-        "<%= config.bin %> sandbox reset",
-        "<%= config.bin %> sandbox reset --format json"
+        "<%= config.bin %> sandbox emit impression.recorded",
+        "<%= config.bin %> sandbox emit heartbeat",
+        "<%= config.bin %> sandbox emit impression.recorded --data '{\"cpm\": 3.50}'"
       ],
       "flags": {
         "api-key": {
@@ -6935,11 +7082,19 @@
             "yaml"
           ],
           "type": "option"
+        },
+        "data": {
+          "char": "d",
+          "description": "Additional event data (JSON string)",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sandbox:reset",
+      "id": "sandbox:emit",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -6950,16 +7105,16 @@
         "dist",
         "commands",
         "sandbox",
-        "reset.js"
+        "emit.js"
       ]
     },
-    "sandbox:status": {
+    "sandbox:reset": {
       "aliases": [],
       "args": {},
-      "description": "Show sandbox status — screens and recent events",
+      "description": "Reset the sandbox — delete all test screens and events",
       "examples": [
-        "<%= config.bin %> sandbox status",
-        "<%= config.bin %> sandbox status --format json"
+        "<%= config.bin %> sandbox reset",
+        "<%= config.bin %> sandbox reset --format json"
       ],
       "flags": {
         "api-key": {
@@ -6993,7 +7148,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sandbox:status",
+      "id": "sandbox:reset",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -7004,18 +7159,16 @@
         "dist",
         "commands",
         "sandbox",
-        "status.js"
+        "reset.js"
       ]
     },
-    "screens:watch": {
+    "sandbox:status": {
       "aliases": [],
       "args": {},
-      "description": "Live fleet dashboard — watch all screens in real-time",
+      "description": "Show sandbox status — screens and recent events",
       "examples": [
-        "<%= config.bin %> screens watch",
-        "<%= config.bin %> screens watch --filter online",
-        "<%= config.bin %> screens watch --sort earnings",
-        "<%= config.bin %> screens watch --format json"
+        "<%= config.bin %> sandbox status",
+        "<%= config.bin %> sandbox status --format json"
       ],
       "flags": {
         "api-key": {
@@ -7045,43 +7198,11 @@
             "yaml"
           ],
           "type": "option"
-        },
-        "filter": {
-          "description": "Filter screens by status",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "online",
-            "offline"
-          ],
-          "type": "option"
-        },
-        "interval": {
-          "description": "Refresh interval in seconds",
-          "name": "interval",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort": {
-          "description": "Sort column",
-          "name": "sort",
-          "default": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "name",
-            "earnings",
-            "fill-rate"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "screens:watch",
+      "id": "sandbox:status",
       "pluginAlias": "@trillboards/cli",
       "pluginName": "@trillboards/cli",
       "pluginType": "core",
@@ -7091,10 +7212,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "screens",
-        "watch.js"
+        "sandbox",
+        "status.js"
       ]
     }
   },
-  "version": "0.1.9"
+  "version": "0.1.10"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@trillboards/cli",
   "description": "Official CLI for the Trillboards DOOH API",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "author": "Trillboards",
   "bin": {
     "trillboards": "./bin/run.js"