└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # AdGuard Sitereport website 2 | 3 | ## Overview 4 | 5 | Receives structured query parameters from AdGuard products (Windows, macOS, Android, iOS, Browser Extensions) to prefill the report form for broken websites or missed ads. 6 | 7 | https://reports.adguard.com/new_issue.html 8 | 9 | ## Parameters table 10 | 11 | | Parameter | Type | Format / Example | Description | Platform | Notes | 12 | |------------|------|------------------|--------------|-----------|--------| 13 | | `scheme_version` | int | `3` | Defines schema version for parameters | All | | 14 | | `product_type` | string | `win`, `mac`, `mmini`, `and`, `ios`, `ext`, `saf`, `con`, `dns`, `other` | Product identifier | All | | 15 | | `product_version` | string | `7.15.2` | Product version string | All | | 16 | | `system_version` | string | `11.0.1` | OS version string | All | | 17 | | `url` | string | `https%3A%2F%2Fexample.com` | Target page being reported | All | | 18 | | `filters` | string | `2.3.4.224` | Dot-separated list of filter IDs | All | Divider `.` | 19 | | `filters_last_update` | string | `2025-10-31-18-00-00` | Timestamp in UTC | All | | 20 | | `custom_filters` | string | Comma-separated list | User-added filters | All | Divider `,` | 21 | | `userscripts` | string | Comma-separated list | Enabled userscripts or Android extensions equivalent | All | Divider `,` | 22 | | `dns.enabled` | bool | `true` / `false` | Whether DNS protection or proxy module is enabled | All | | 23 | | `dns.filters` | string | Desktop: `2.3.4` (IDs), Mobile: URLs | DNS filters applied | All | Platform-dependent format | 24 | | `dns.servers` | string | Desktop: IPs/System, Mobile: URLs | Active DNS servers | All | Divider `,` | 25 | | `dns.bootstrap` | string | `1.1.1.1,8.8.8.8` | Bootstrap servers | All | Divider `,` | 26 | | `dns.fallback` | string | `8.8.4.4,1.0.0.1` | Fallback servers | All | Divider `,` | 27 | | `dns.timeout` | int | `5000` | Timeout in ms | All | | 28 | | `dns.custom_bootstrap` | string | `1.1.1.1` | Custom bootstrap DNS servers list | Win, Mac | Divider `,` or `\n` | 29 | | `dns.custom_fallback` | string | `8.8.8.8` | Custom fallback DNS servers list | Win, Mac | Divider `,` or `\n` | 30 | | `dns.custom_filters` | string | `[Name] (url: [URL])` | Custom DNS filters | Win, Mac | Divider `,` | 31 | | `dns.fallback_mode` | string | `System`, `Custom`, `None` | DNS fallback behavior | Win, Mac | | 32 | | `extensions` | string | `[Name] ([type]; url: [URL])` | List of enabled extensions | Win, Mac | Divider `,` | 33 | | `extensions.enabled` | bool | `true` / `false` | Whether extensions are enabled | Win, Mac | | 34 | | `adblocking.enabled` | bool | `true` / `false` | Ad blocking feature state | Win, Mac | | 35 | | `license_type` | string | `paid`, `free` | License kind | All | | 36 | | `user_agent` | string | Browser UA string | Client identification | All | | 37 | | `browser` | string | `chrome`, `edge`, `firefox`, `opera`, `safari`, `yandex`, `other`, `firefox mobile`, `firefox preview`, `uc browser`, `yandex lite`, `samsung browser`, `duckduckgo`, `vivaldi`, `brave` | Browser name | All | | 38 | | `browser_detail` | string | `Midori/1.0` | Other browser details | All | | 39 | | `manifest_version` | int | `2` or `3` | Chrome manifest version | Ext | | 40 | | `win.wfp` | bool | `true` / `false` | Windows Filtering Platform | Win | | 41 | | `browsing_security.enabled` | bool | `true` / `false` | Safe browsing enabled | Win, Mac, And, iOS | Excluded for MV3 | 42 | | `browsing_security.statistics_enabled` | bool | `true` / `false` | Collect usage statistics | Win, Mac | | 43 | | `stealth.enabled` | bool | `true` / `false` | Stealth mode status | All | | 44 | | `stealth.block_trackers` | bool | `true` / `false` | Block trackers | All | | 45 | | `stealth.block_third_party_auth` | bool | `true` / `false` | Block third-party auth | Win, Mac | | 46 | | `stealth.disable_third_party_cache` | bool | `true` / `false` | Disable 3rd party cache | Win, Mac | | 47 | | `stealth.disable_wap_push_message_routing_service` | bool | `true` / `false` | Disable WAP Push Routing | Win | | 48 | | `stealth.disable_windows_defender` | bool | `true` / `false` | Disable Windows Defender | Win | | 49 | | `stealth.disable_windows_telemetry` | bool | `true` / `false` | Disable Windows telemetry | Win | | 50 | | `stealth.disable_windows_recall` | bool | `true` / `false` | Disable Windows Recall | Win | | 51 | | `stealth.flash` | bool | `true` / `false` | Block Flash | Win, Mac | | 52 | | `stealth.java` | bool | `true` / `false` | Block Java | Win, Mac | | 53 | | `stealth.location` | bool | `true` / `false` | Block Location API | Win, Mac | | 54 | | `stealth.push` | bool | `true` / `false` | Block Push API | Win, Mac | | 55 | | `stealth.turn_off_advertising_id` | bool | `true` / `false` | Turn off Advertising ID | Win | | 56 | | `stealth.x_client` | bool | `true` / `false` | Remove X-Client-Data header | Win, Mac | | 57 | | `stealth.dpi` | bool | `true` / `false` | Hide TLS SNI | Win, Mac | | 58 | | `stealth.ip` | string | Custom IP address | IP spoofing value | Win | | 59 | | `stealth.referrer` | string | Custom Referer header | Set custom Referer | Win, Mac | | 60 | | `stealth.user_agent` | string | Custom UA string | Spoofed user agent | Win, Mac | | 61 | | `stealth.first_party_cookies` | int | TTL (minutes) | First-party cookie TTL | Win, Mac | | 62 | | `stealth.third_party_cookies` | int | TTL (minutes) | Third-party cookie TTL | Win, Mac | | 63 | | `stealth.block_webrtc` | bool | `true` / `false` | Block WebRTC | All | | 64 | | `stealth.strip_url` | bool | `true` / `false` | Remove URL parameters | All | | 65 | | `stealth.hide_search_queries` | bool | `true` / `false` | Hide search queries | All | | 66 | | `stealth.send_dnt` | bool | `true` / `false` | Send DNT | All | | 67 | | `stealth.self_destruct_cookies` | int | `15` | TTL (minutes) | All | | 68 | | `android.mode` | string | `VPN`, `Proxy` | Operation mode | And | | 69 | | `android.method` | string | `Full`, `Simple` | Filtering method | And | | 70 | | `android.https_filtering` | bool | `true` / `false` | HTTPS filtering active | And | | 71 | | `android.root` | bool | `true` / `false` | Root status | And | | 72 | | `is_third_party_cookies` | bool | `true` / `false` | Self-destructing third-party cookies flag | And | | 73 | | `is_first_party_cookies` | bool | `true` / `false` | Self-destructing first-party cookies flag | And | | 74 | 75 | ## Deprecated Parameters 76 | 77 | | Parameter | Type | Format / Example | Description | Platform | Notes | 78 | |------------|------|------------------|--------------|-----------|--------| 79 | | `parental_control.enabled` | bool | `true` / `false` | Parental control enabled | Win, Mac | | 80 | | `parental_control.block_exe` | bool | `true` / `false` | Block executable downloads | Win, Mac | | 81 | | `parental_control.safe_search` | bool | `true` / `false` | Enforce Safe Search | Win, Mac | | 82 | 83 | ## Tracking parameters 84 | 85 | These parameters are not used by the report tool but may appear in the URL as part of internal tracking or URL shortener mechanisms: 86 | 87 | | Parameter | Type | Example | Description | 88 | | --------- | ------ | ---------------------- | ---------------------------------------------------- | 89 | | `action` | string | `report` | Marks the context of the action, used for analytics. | 90 | | `from` | string | `popup` / `background` | Indicates request origin for tracking. | 91 | | `app` | string | `browser_extension` | App name | 92 | 93 | ## Scheme versioning 94 | 95 | All products must include `scheme_version`. The current version (`3`) defines unified DNS data inclusion from meta information 96 | 97 | ## Validation rules 98 | 99 | - Unknown or deprecated parameters are ignored. 100 | - Missing optional parameters default to `false` or empty. 101 | - For `manifest_version=3`, `browsing_security.*` parameters are omitted. 102 | 103 | ## Examples 104 | 105 | ### Windows example 106 | ``` 107 | https://reports.adguard.com/en/new_issue.html?scheme_version=3&product_type=Win&product_version=7.15.2&system_version=Microsoft%20Windows%2011&url=https%3A%2F%2Fexample.com&filters=2.3.4.224&filters_last_update=2025-10-31-12-00-00&custom_filters=User%20rules%20(url%3A%20none)&userscripts=DarkMode&dns.enabled=true&dns.filters=adguard-dns&dns.servers=System&dns.custom_bootstrap=1.1.1.1%2C8.8.8.8&dns.fallback=8.8.4.4%2C1.0.0.1&dns.timeout=5000&adblocking.enabled=true&browsing_security.enabled=true&browsing_security.statistics_enabled=true&extensions.enabled=true&extensions=AdGuard%20Assistant%20(script%3B%20url%3A%20https%3A%2F%2Fexample.com)&license_type=paid&win.wfp=true&parental_control.enabled=true&parental_control.block_exe=false&parental_control.safe_search=true&stealth.enabled=true&stealth.block_trackers=true&stealth.strip_url=true&stealth.block_third_party_auth=true&stealth.disable_windows_defender=true&stealth.disable_windows_recall=true&stealth.disable_windows_telemetry=true&stealth.turn_off_advertising_id=true&stealth.hide_search_queries=true&stealth.x_client=true&stealth.flash=true&stealth.java=true&stealth.push=true&stealth.block_webrtc=true&stealth.dpi=true&stealth.send_dnt=true&stealth.first_party_cookies=15&stealth.third_party_cookies=30 108 | ``` 109 | 110 | ### macOS example 111 | ``` 112 | https://reports.adguard.com/en/new_issue.html?scheme_version=3&product_type=Mac&product_version=2.14.0&system_version=macOS%2015.0&url=https%3A%2F%2Fads.example.com&filters=2.4.5.50&filters_last_update=2025-10-31-10-00-00&custom_filters=Custom%20List%20(url%3A%20https%3A%2F%2Fexample.org%2Ffilter.txt)&dns.enabled=true&dns.filters=adguard-dns&dns.servers=System&dns.timeout=3000&browsing_security.enabled=true&browsing_security.statistics_enabled=true&stealth.enabled=true&stealth.block_trackers=true&stealth.strip_url=true&stealth.hide_search_queries=true&stealth.send_dnt=true&stealth.block_webrtc=true&stealth.self_destruct_cookies=10 113 | ``` 114 | 115 | ### Android example 116 | ``` 117 | https://reports.adguard.com/en/new_issue.html?scheme_version=3&product_type=And&product_version=4.3&system_version=Android%2015&url=https%3A%2F%2Fexample.org&filters=2.3.4.200&filters_last_update=2025-10-31-11-00-00&custom_filters=Mobile%20Rules%20(url%3A%20none)&dns.enabled=true&dns.filters=adguard-dns&dns.servers=System&dns.timeout=4000&browsing_security.enabled=true&stealth.enabled=true&stealth.block_trackers=true&stealth.strip_url=true&stealth.block_webrtc=true&stealth.send_dnt=true&android.mode=VPN&android.method=Full&android.https_filtering=true&android.root=false 118 | ``` 119 | 120 | ### iOS example 121 | ``` 122 | https://reports.adguard.com/en/new_issue.html?scheme_version=3&product_type=iOS&product_version=4.5.1&system_version=iOS%2018.0&url=https%3A%2F%2Fnews.example.com&filters=2.3.4.205&filters_last_update=2025-10-31-09-00-00&dns.enabled=true&dns.filters=adguard-dns&browsing_security.enabled=true&stealth.enabled=true&stealth.block_trackers=true&stealth.strip_url=true&stealth.send_dnt=true 123 | ``` 124 | 125 | ### Browser Extension example (Manifest V3) 126 | ``` 127 | https://reports.adguard.com/en/new_issue.html?scheme_version=3&product_type=Ext&product_version=5.0.1&manifest_version=3&system_version=Chrome%20128.0.6613.114&browser=chrome&url=https%3A%2F%2Fexample.net&filters=2.3.4.300&filters_last_update=2025-10-31-14-00-00&stealth.enabled=true&stealth.block_trackers=true&stealth.strip_url=true&stealth.hide_search_queries=true&stealth.send_dnt=true&stealth.block_webrtc=true 128 | ``` 129 | --------------------------------------------------------------------------------