{ "openapi": "3.0.1", "info": { "title": "FCC License Scraper - ULS Call Sign, FRN, Towers & ECFS", "description": "Search FCC ULS licences by call sign, FRN, licensee, service, state, status and dates: amateur, GMRS, land mobile, microwave, cellular, PCS/AWS, paging, marine. Licensee phone, email, address, contact. Tower registrations, new-grant monitor from FCC daily files, ECFS docket filings.", "version": "0.1", "x-build-id": "SablnMr7LYGCodpul" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~fcc-license-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-fcc-license-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapersdelight~fcc-license-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-fcc-license-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapersdelight~fcc-license-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-fcc-license-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to scrape", "enum": [ "licenses", "recentActivity", "ecfsFilings" ], "type": "string", "description": "Licences = search the FCC's weekly ULS files (and tower registrations). Recent activity = licences granted, renewed, modified or cancelled in the FCC's last daily files. ECFS = comments and filings in FCC dockets.", "default": "licenses" }, "radioServices": { "title": "Radio services", "type": "array", "description": "Which FCC files to read (licence counts from the 2026-10-11 files). Bigger files take longer: amateur reads ~150 MB. Not used by ECFS.", "items": { "type": "string", "enum": [ "cellular", "landMobileCommercial", "landMobilePrivate", "broadcastAuxiliary", "microwave", "marketBased", "paging", "brsEbs", "coastGround", "amateur", "gmrs", "ship", "aircraft", "commercialOperators", "antennaStructures" ], "enumTitles": [ "Cellular (800 MHz) - 5,464 licences", "Land mobile - commercial (SMR, 220 MHz, 900 MHz) - 81,077", "Land mobile - private (business/industrial, public safety) - 860,739", "Land mobile - broadcast auxiliary (remote pickup, low power) - 21,570", "Microwave (point-to-point, TV/aural STL, 3650 MHz, 70/80/90 GHz) - 367,252", "Market-based (PCS, AWS, 600/700 MHz, CBRS PAL, 3.45/3.7 GHz, UMFUS, WCS) - 174,016", "Paging and radiotelephone (Part 22) - 9,604", "BRS / EBS (2.5 GHz broadband) - 18,958", "Coast and ground stations (marine, aviation) - 35,860", "Amateur radio (ham) - 1,697,931", "GMRS - 615,496", "Ship stations - 402,861", "Aircraft stations - 152,971", "Commercial and restricted radio operator licences - 793,162", "Antenna structure registrations (towers, ASR) - 197,769" ] }, "default": [ "cellular" ] }, "callSigns": { "title": "Call signs", "type": "array", "description": "Look up these call signs, e.g. W1AW, KNKA671, WSHM478. Exact match, case does not matter. Searches the radio services selected above.", "items": { "type": "string" } }, "frns": { "title": "FRNs (FCC Registration Numbers)", "type": "array", "description": "Every licence (or tower) held under these FRNs, e.g. 0003291341. Leading zeros optional.", "items": { "type": "string" } }, "licenseeNames": { "title": "Licensee name contains", "type": "array", "description": "Licensee (or tower owner) name contains any of these, case-insensitive, e.g. verizon, county of, school district.", "items": { "type": "string" } }, "statuses": { "title": "Licence status", "type": "array", "description": "Keep licences with these FCC statuses. Empty = Active only for a licence search, any status for recent activity. Select all to include expired and cancelled licences.", "items": { "type": "string", "enum": [ "A", "C", "E", "L", "P", "T", "X" ], "enumTitles": [ "Active (A)", "Canceled (C)", "Expired (E)", "Pending Legal Status (L)", "Parent Station Canceled (P)", "Terminated (T)", "Term Pending (X)" ] } }, "radioServiceCodes": { "title": "Radio service codes", "type": "array", "description": "Narrow to these FCC service codes (e.g. HA amateur, IG industrial/business, PW public safety, CW PCS, AW AWS). With no radio service picked above, the file holding each code is read.", "items": { "type": "string", "enum": [ "AA", "AB", "AC", "AD", "AF", "AH", "AI", "AR", "AS", "AT", "AW", "BA", "BB", "BC", "BR", "BS", "CA", "CB", "CD", "CE", "CF", "CG", "CJ", "CL", "CM", "CN", "CO", "CP", "CR", "CT", "CW", "CY", "CZ", "DV", "ED", "GB", "GC", "GE", "GF", "GI", "GJ", "GM", "GO", "GP", "GR", "GS", "GU", "GX", "HA", "HV", "IG", "IK", "IQ", "LD", "LN", "LP", "LS", "LV", "LW", "MA", "MC", "MG", "MK", "MM", "MR", "MS", "MW", "NC", "NN", "PA", "PB", "PC", "PE", "PF", "PK", "PL", "PM", "PW", "QA", "QD", "QM", "QO", "QQ", "QT", "RP", "RR", "RS", "SA", "SB", "SE", "SG", "SL", "SP", "SY", "TB", "TC", "TI", "TN", "TP", "TS", "TT", "TZ", "UU", "WA", "WS", "WT", "WU", "WX", "WY", "WZ", "YB", "YC", "YD", "YE", "YF", "YG", "YH", "YI", "YJ", "YK", "YM", "YO", "YP", "YS", "YU", "YW", "YX", "ZA", "ZV" ], "enumTitles": [ "AA - Aviation Auxiliary Group [Coast & ground]", "AB - Aural Microwave Booster [Microwave]", "AC - Aircraft [Aircraft]", "AD - AWS-4 (2000-2020 MHz and 2180-2200 MHz) [Market-based]", "AF - Aeronautical and Fixed [Coast & ground]", "AH - AWS-H Block (at 1915-1920 MHz and 1995-2000 MHz) [Market-based]", "AI - Aural Intercity Relay [Microwave]", "AR - Aviation Radionavigation [Coast & ground]", "AS - Aural Studio Transmitter Link [Microwave]", "AT - AWS-3 (1695-1710 MHz, 1755-1780 MHz, and 2155-2180 MHz) [Market-based]", "AW - AWS (1710-1755 MHz and 2110-2155 MHz) [Market-based]", "BA - 1390-1392 MHz Band, Market Area [Market-based]", "BB - 1392-1395 and 1432-1435 MHz Bands, Market Area [Market-based]", "BC - 1670-1675 MHz Band, Market Area [Market-based]", "BR - Broadband Radio Service [BRS/EBS]", "BS - 900 MHz Broadband Service [Market-based]", "CA - Commercial Air-ground Radiotelephone [Paging]", "CB - BETRS [Paging]", "CD - Paging and Radiotelephone [Paging]", "CE - Digital Electronic Message Service - Common Carrier [Microwave]", "CF - Common Carrier Fixed Point to Point Microwave [Microwave]", "CG - General Aviation Air-ground Radiotelephone [Paging]", "CJ - Commercial Aviation Air-Ground Radiotelephone (800 MHz band) [Market-based]", "CL - Cellular [Cellular]", "CM - Commercial Operator [Commercial operators]", "CN - PCS Narrowband [Market-based]", "CO - Offshore Radiotelephone [Paging]", "CP - Part 22 VHF/UHF Paging (excluding 931MHz) [Market-based]", "CR - Rural Radiotelephone [Paging]", "CT - Local Television Transmission [Microwave]", "CW - PCS Broadband [Market-based]", "CY - 1910-1915/1990-1995 MHz Bands, Market Area [Market-based]", "CZ - Part 22 931 MHZ Paging [Market-based]", "DV - Multichannel Video Distribution AND Data Service [Market-based]", "ED - Educational Broadband Service [BRS/EBS]", "GB - Business, 806-821/851-866 MHz, Conventional [Land mobile private]", "GC - 929-931 MHz Band, Auctioned [Market-based]", "GE - PubSafty/SpecEmer/PubSaftyNtlPlan,806-817/851-862MHz,Conv [Land mobile private]", "GF - Public Safety Ntl Plan, 821-824/866-869 MHz, Conv. [Land mobile private]", "GI - Other Indust/Land Transp, 896-901/935-940 MHz, Conv. [Land mobile private]", "GJ - Business/Industrial/Land Trans, 809-824/854-869 MHz, Conv. [Land mobile private]", "GM - 800 MHz Conventional SMR (SMR, Site-specific) [Land mobile commercial]", "GO - Other Indust/Land Transp, 806-821/851-866 MHz, Conv. [Land mobile private]", "GP - Public Safety/Spec Emerg, 806-821/851-866 MHz, Conv. [Land mobile private]", "GR - SMR, 896-901/935-940 MHz, Conventional [Land mobile commercial]", "GS - Private Carrier Paging, 929-930 MHz [Land mobile commercial]", "GU - Business, 896-901/935-940 MHz, Conventional [Land mobile private]", "GX - SMR, 806-821/851-866 MHz, Conventional [Land mobile commercial]", "HA - Amateur [Amateur]", "HV - Vanity [Amateur]", "IG - Industrial/Business Pool, Conventional [Land mobile private]", "IK - Industrial/Business Pool - Commercial, Conventional [Land mobile commercial]", "IQ - Intelligent Transportation Service (Public Safety) [Land mobile private]", "LD - Local Multipoint Distribution Service [Market-based]", "LN - 902-928 MHz Location Narrowband (Non-multilateration) [Land mobile commercial]", "LP - Broadcast Auxiliary Low Power [Broadcast auxiliary]", "LS - Location and Monitoring Service, Multilateration (LMS) [Market-based]", "LV - Low Power Wireless Assist Video Devices [Broadcast auxiliary]", "LW - 902-928 MHz Location Wideband (Grandfathered AVM) [Land mobile commercial]", "MA - Marine Auxiliary Group [Coast & ground]", "MC - Coastal Group [Coast & ground]", "MG - Microwave Industrial/Business Pool [Microwave]", "MK - Alaska Group [Coast & ground]", "MM - Millimeter Wave 70/80/90 GHz Service [Microwave]", "MR - Marine Radiolocation Land [Coast & ground]", "MS - Multiple Address Service, Auctioned [Market-based]", "MW - Microwave Public Safety Pool [Microwave]", "NC - Nationwide Commercial 5 Channel, 220 MHz [Land mobile commercial]", "NN - 3650-3700 MHz [Microwave]", "PA - Public Safety 4940-4990 MHz Band [Land mobile private]", "PB - 4940-4990 MHz Public Safety, Base/Mobile [Land mobile private]", "PC - Public Coast Stations, Auctioned [Market-based]", "PE - Digital Electronic Message Service - Private [Microwave]", "PF - 4940-4990 MHz Public Safety, Pt-to-Pt, Pt-to-Multi-Pt [Microwave]", "PK - 3.45 GHz Service [Market-based]", "PL - 3.5 GHz Band Priority Access License [Market-based]", "PM - 3.7 GHz Service [Market-based]", "PW - Public Safety Pool, Conventional [Land mobile private]", "QA - 220-222 MHz Band, Auctioned [Market-based]", "QD - Non-Nationwide Data, 220 MHz [Land mobile commercial]", "QM - Non-Nationwide Public Safety/Mutual Aid, 220 MHz [Land mobile private]", "QO - Non-Nationwide Other, 220 MHz [Land mobile commercial]", "QQ - Intelligent Transportation Service (Non-Public Safety) [Land mobile private]", "QT - Non-Nationwide 5 Channel Trunked, 220 MHz [Land mobile commercial]", "RP - Broadcast Auxiliary Remote Pickup [Broadcast auxiliary]", "RR - Restricted Operator [Commercial operators]", "RS - Land Mobile Radiolocation [Land mobile private]", "SA - Ship Recreational or Voluntarily Equipped [Ship]", "SB - Ship Compulsory Equipped [Ship]", "SE - Ship Exemption [Ship]", "SG - Conventional Public Safety 700 MHz [Land mobile private]", "SL - Public Safety 700 MHZ Band-State License [Land mobile private]", "SP - 700 MHz Public Safety Broadband Nationwide License [Land mobile private]", "SY - Trunked Public Safety 700 MHz [Land mobile private]", "TB - TV Microwave Booster [Microwave]", "TC - MSS Ancillary Terrestrial Component (ATC) Leasing [Market-based]", "TI - TV Intercity Relay [Microwave]", "TN - 39 Ghz, Auctioned [Market-based]", "TP - TV Pickup [Microwave]", "TS - TV Studio Transmitter Link [Microwave]", "TT - TV Translator Relay [Microwave]", "TZ - 24 GHz Service [Market-based]", "UU - Upper Microwave Flexible Use Service [Market-based]", "WA - Microwave Aviation [Microwave]", "WS - Wireless Communications Service [Market-based]", "WT - 600 MHz Band [Market-based]", "WU - 700 MHz Upper Band (Block C) [Market-based]", "WX - 700 MHz Guard Band [Market-based]", "WY - 700 MHz Lower Band (Blocks A, B & E) [Market-based]", "WZ - 700 MHz Lower Band (Blocks C, D) [Market-based]", "YB - Business, 806-821/851-866 MHz, Trunked [Land mobile private]", "YC - SMR, 806-821/851-866 MHz, Auctioned [Market-based]", "YD - SMR, 896-901/935-940 MHz, Auctioned [Market-based]", "YE - PubSafty/SpecEmer/PubSaftyNtlPlan,806-817/851-862MHz,Trunked [Land mobile private]", "YF - Public Safety Ntl Plan, 821-824/866-869 MHz, Trunked [Land mobile private]", "YG - Industrial/Business Pool, Trunked [Land mobile private]", "YH - SMR, 806-821/851-866 MHz, Auctioned (Rebanded YC license) [Market-based]", "YI - Other Indust/Land Transp. 896-901/935-940 MHz, Trunked [Land mobile private]", "YJ - Business/Industrial/Land Trans, 809-824/854-869 MHz, Trunked [Land mobile private]", "YK - Industrial/Business Pool - Commercial, Trunked [Land mobile commercial]", "YM - 800 MHz Trunked SMR (SMR, Site-specific) [Land mobile commercial]", "YO - Other Indust/Land Transp. 806-821/851-866 MHz, Trunked [Land mobile private]", "YP - Public Safety/Spec Emerg, 806-821/851-866 MHz, Trunked [Land mobile private]", "YS - SMR, 896-901/935-940 MHz, Trunked [Land mobile commercial]", "YU - Business, 896-901/935-940 MHz, Trunked [Land mobile private]", "YW - Public Safety Pool, Trunked [Land mobile private]", "YX - SMR, 806-821/851-866 MHz, Trunked [Land mobile commercial]", "ZA - General Mobile Radio (GMRS) [GMRS]", "ZV - 218-219 MHz Service [Market-based]" ] } }, "states": { "title": "States", "type": "array", "description": "Two-letter state of the licensee's mailing address, e.g. TX, CA. For towers: the state the structure stands in.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Exact city of the licensee's address (towers: structure city), e.g. HOUSTON. Combine with states to avoid same-name cities.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes (prefix)", "type": "array", "description": "ZIP code or its start, e.g. 77002 or 770 (all of Houston).", "items": { "type": "string" } }, "applicantTypes": { "title": "Applicant type", "type": "array", "description": "Licensee / owner legal form as filed with the FCC, e.g. Corporation, LLC, Individual, Governmental Entity.", "items": { "type": "string", "enum": [ "B", "C", "D", "E", "F", "G", "H", "I", "J", "L", "M", "N", "O", "P", "R", "T", "U", "Z" ], "enumTitles": [ "Amateur Club", "Corporation", "General Partnership", "Limited Partnership", "Limited Liability Partnership", "Governmental Entity", "Other", "Individual", "Joint Venture", "Limited Liability Company", "Military Recreation", "Tribal Entity", "Consortium", "Partnership", "RACES", "Trust", "Unincorporated Association", "Tribal Entity Controlled by a Business" ] } }, "operatorClasses": { "title": "Operator class", "type": "array", "description": "Amateur licence class (Extra, General, Technician...) or commercial operator licence (GROL, MROP, GMDSS...).", "items": { "type": "string", "enum": [ "A", "E", "G", "N", "P", "T", "DB", "DM", "DO", "MP", "PG", "RG", "RL", "RR", "T1", "T2", "T3" ], "enumTitles": [ "Amateur: Advanced", "Amateur: Amateur Extra", "Amateur: General", "Amateur: Novice", "Amateur: Technician Plus", "Amateur: Technician", "Commercial operator: GMDSS Radio Operator/Maintainer License", "Commercial operator: GMDSS Radio Maintainer's License", "Commercial operator: GMDSS Radio Operator's License", "Commercial operator: Marine Radio Operator Permit", "Commercial operator: General Radiotelephone Operator License", "Commercial operator: GMDSS Restricted Radio Operator License", "Commercial operator: Restricted Radiotelephone Operator Permit-Limited Use", "Commercial operator: Restricted Radiotelephone Operator Permit", "Commercial operator: First Class Radiotelegraph Operator's Certificate", "Commercial operator: Second Class Radiotelegraph Operator's Certificate", "Commercial operator: Third Class Radiotelegraph Operator's Certificate" ] } }, "grantedFrom": { "title": "Granted from", "type": "string", "description": "Licences granted on or after this date (towers: registration issued)." }, "grantedTo": { "title": "Granted until", "type": "string", "description": "Licences granted on or before this date." }, "expiresFrom": { "title": "Expires from", "type": "string", "description": "Licences expiring on or after this date." }, "expiresTo": { "title": "Expires until", "type": "string", "description": "Licences expiring on or before this date." }, "lastActionFrom": { "title": "Last action from", "type": "string", "description": "Last FCC action (grant, renewal, modification, cancellation) on or after this date." }, "lastActionTo": { "title": "Last action until", "type": "string", "description": "Last FCC action on or before this date." }, "expiringWithinDays": { "title": "Expiring within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Active licences whose expiration date falls in the next N days - renewal leads, e.g. 90." }, "frequencyFromMhz": { "title": "Frequency from (MHz)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Licences with an assigned frequency or band in this range (inclusive). Set both; equal values = one exact frequency, e.g. 462.5625. Reads the frequency file too." }, "frequencyToMhz": { "title": "Frequency to (MHz)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Upper end of the frequency range, e.g. 467.7125." }, "towerStatuses": { "title": "Tower status", "type": "array", "description": "ASR registration status. Empty = Constructed and Granted for a search, any status for recent activity.", "items": { "type": "string", "enum": [ "C", "G", "A", "I", "T", "D", "N", "O", "P", "R", "W" ], "enumTitles": [ "Constructed", "Granted (not yet constructed)", "Canceled", "Dismantled", "Terminated", "Dismissed", "Inactive", "Owner removed", "Pending", "Returned", "Withdrawn" ] } }, "structureTypes": { "title": "Structure types", "type": "array", "description": "Kind of structure as registered, e.g. Monopole, Lattice tower, Guyed tower, Building.", "items": { "type": "string", "enum": [ "TOWER", "LTOWER", "MTOWER", "GTOWER", "POLE", "MAST", "B", "BANT", "UPOLE", "TANK", "BTWR", "TREE", "RIG", "BMAST", "BPOLE", "SILO", "PIPE", "STACK", "BPIPE", "SIGN", "BRIDG", "NTOWER" ], "enumTitles": [ "TOWER - Free standing or Guyed Structure used for Commu", "LTOWER - Lattice Tower", "MTOWER - Monopole", "GTOWER - Guyed Structure Used for Communication Purposes", "POLE - Any type of Pole", "MAST - Mast", "B - Building", "BANT - Building with Antenna on top", "UPOLE - Utility Pole/Tower used to provide service (Ele", "TANK - Any type of Tank (Water, Gas, etc)", "BTWR - Building with Tower", "TREE - When used as a support for an antenna", "RIG - Oil or other type of Rig", "BMAST - Building with Mast", "BPOLE - Building with Pole", "SILO - Any type of Silo", "PIPE - Any type of Pipe", "STACK - Smoke Stack", "BPIPE - Building with Pipe", "SIGN - Any Type of Sign or Billboard", "BRIDG - Bridge", "NTOWER - Multiple Structures - The N is the # of structu" ] } }, "minHeightMeters": { "title": "Min height (m)", "minimum": 0, "maximum": 3000, "type": "number", "description": "Overall height above ground of at least this many meters, e.g. 60." }, "maxHeightMeters": { "title": "Max height (m)", "minimum": 0, "maximum": 3000, "type": "number", "description": "Overall height above ground of at most this many meters." }, "businessOnly": { "title": "Businesses only", "type": "boolean", "description": "Keep licensees filed as a corporation, LLC, partnership, trust or association - drops individuals, governments and amateur clubs.", "default": false }, "requireEmail": { "title": "With email only", "type": "boolean", "description": "Keep licences that list an email (licensee or licence contact).", "default": false }, "requirePhone": { "title": "With phone only", "type": "boolean", "description": "Keep licences that list a phone number (licensee or licence contact).", "default": false }, "recentDays": { "title": "Daily files to read", "minimum": 1, "maximum": 7, "type": "integer", "description": "How many of the FCC's most recent non-empty daily files to read per service: 1 = the latest day of actions, 7 = the whole week.", "default": 3 }, "eventTypes": { "title": "Actions to include", "type": "array", "description": "Which FCC actions to return. Default: new grants only - the new-licensee feed.", "items": { "type": "string", "enum": [ "newGrant", "renewal", "modification", "cancellation", "expiration", "termination", "assignment", "transferOfControl", "adminUpdate", "lease", "construction", "dismantlement", "otherUpdate" ], "enumTitles": [ "New licence granted", "Renewed", "Modified", "Cancelled", "Set to expired", "Terminated", "Assigned / ownership change", "Transfer of control", "Administrative update", "Lease action", "Tower constructed", "Tower dismantled", "Other update" ] }, "default": [ "newGrant" ] }, "ecfsProceedings": { "title": "Docket numbers", "type": "array", "description": "FCC proceeding / docket numbers, e.g. 23-320, 17-108, 25-133. Each is searched separately.", "items": { "type": "string" } }, "ecfsFiler": { "title": "Filer name", "type": "string", "description": "Only filings by this filer, e.g. Verizon, AT&T Services Inc., NTCA." }, "ecfsQuery": { "title": "Search words", "type": "string", "description": "Full-text search across filings, e.g. spectrum sharing, net neutrality." }, "ecfsReceivedFrom": { "title": "Received from", "type": "string", "description": "Filings received on or after this date." }, "ecfsReceivedTo": { "title": "Received until", "type": "string", "description": "Filings received on or before this date." }, "ecfsSubmissionTypes": { "title": "Filing types", "type": "array", "description": "Keep only these filing types as ECFS names them, e.g. COMMENT, REPLY TO COMMENTS, NOTICE OF EXPARTE, LETTER, PETITION FOR RECONSIDERATION.", "items": { "type": "string" } }, "ecfsExcludeExpressComments": { "title": "Skip express comments", "type": "boolean", "description": "Drop one-line public \"express\" comments (millions on some dockets) and keep formal filings.", "default": false }, "ecfsSort": { "title": "Order", "enum": [ "newestReceived", "oldestReceived", "newestDisseminated" ], "type": "string", "description": "Newest received first reads past ECFS's 10,000-filings-per-query limit; the other orders stop there.", "default": "newestReceived" }, "includeFrequencies": { "title": "Frequencies", "type": "boolean", "description": "Add assigned frequencies and bands (MHz) to each licence.", "default": false }, "includeLocations": { "title": "Transmitter locations", "type": "boolean", "description": "Add licensed locations: address, county, latitude/longitude, structure height, tower registration number.", "default": false }, "includeHistory": { "title": "History", "type": "boolean", "description": "Add the FCC action history of each licence or tower (dates and actions).", "default": false }, "monitorMode": { "title": "Only new rows", "type": "boolean", "description": "Return only licences, actions or filings this monitor has not delivered in earlier runs. Rows already delivered are not charged again.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name to keep separate monitors apart, e.g. texas-new-gmrs. Empty = one monitor per set of filters." }, "resetMonitor": { "title": "Reset monitor", "type": "boolean", "description": "Forget what this monitor delivered and start over.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Stop after this many rows. 0 = no limit (amateur alone has 822,954 active licences).", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "fileOrder", "newestGrant", "latestAction", "soonestExpiry", "tallestStructure" ], "type": "string", "description": "File order is fastest (stops at Max results). Any other order reads the whole file first.", "default": "fileOrder" }, "includeRawRecord": { "title": "Raw FCC record", "type": "boolean", "description": "Attach the FCC's own columns (HD, EN, AM... rows) to each row.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Only used if the FCC refuses the direct download; the actor then tries a residential proxy and the Apify Unblocker on its own, within a small budget.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }