This section documents the V3 Reporting API endpoints that provide access to comprehensive audit and journey data from ObservePoint. Use these endpoints to retrieve detailed reports, export data, manage alerts, and analyze web performance metrics from your ObservePoint scans.
V3 API
https://api.observepoint.com/
Filters applicable to Request Privacy report
broken
- initial or final URL arebroken
,good
- initial URL isgood
orredirect
and final URL isgood
Page load time in milliseconds. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Page size in bytes. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Number of redirects for a page. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Use in filtering purposes is DEPRECATED in favour of ConsentCategoryId
! Snapshot Id of consent category attached to this run
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/runs/{runId}/reports/request-privacy
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/request-privacy \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"finalPageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"pageTitle": {
"filterType": "contains",
"filterValue": "ObserveP"
},
"initialPageStatusCode": {
"filterType": "specific",
"negated": true
},
"finalPageStatusCode": {
"filterType": "specific",
"negated": true
},
"combinedPageStatusCode": "broken",
"pageLoadTime": {
"min": 0,
"max": 0
},
"pageSize": {
"min": 0,
"max": 0
},
"redirectCount": {
"min": 0,
"max": 0
},
"hasBrokenLinks": true,
"pageUrlMatchingAuditFilterConfiguration": true,
"requestDomain": "example.com",
"consentCategoryId": 3301,
"consentCategorySnapshotId": 33010,
"consentCategoryComplianceStatus": "approved",
"countryCode": "US"
}'
Request Privacy summary data
Number of unique network request domains passing all applied filters
Number of unique network request geolocations passing all applied filters
Total number of unique approved request domains discovered
Number of unique approved request domains passing all applied filters
Total number of unique unapproved domains discovered
Number of unique unapproved domains passing all applied filters
Number of pages with unapproved domains or geos passing all applied filters
When TRUE, run did not have any consent categories assigned. When NOT specified or FALSE, it had at least one.
Total number of approved domain+geo pairs discovered
Number of approved domain+geo pairs passing all applied filters
Total number of unapproved domain+geo pairs discovered
{ "totalPageCount": 0, "filteredPageCount": 0, "totalRequestCount": 0, "filteredRequestCount": 0, "filteredUniqueRequestDomainCount": 0, "filteredUniqueRequestGeoCount": 0, "totalApprovedRequestCount": 0, "totalUniqueApprovedRequestDomainCount": 0, "filteredApprovedRequestCount": 0, "filteredUniqueApprovedRequestDomainCount": 0, "totalUnapprovedRequestCount": 0, "totalUniqueUnapprovedRequestDomainCount": 0, "filteredUnapprovedRequestCount": 0, "filteredUniqueUnapprovedRequestDomainCount": 0, "filteredPageWithUnapprovedRequestCount": 0, "runHasNoConsentCategoriesAssigned": true }
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/runs/{runId}/reports/request-privacy/trends
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/request-privacy/trends \
-H 'Authorization: YOUR_API_KEY_HERE'
Request Privacy trends data
Date-time in RFC3339 profile ISO 8601 format with the following additional restrictions:
- An uppercase T must separate the date and time portions.
- An uppercase Z must denote that a numeric time zone offset isn't present.
In general, these timestamp requirements are the same in AWS Step Functions - Choice Rules
Total number of unique network request domains discovered
Total number of unique network request geolocations discovered
Total number of unique approved request domains discovered
Total number of unique unapproved domains discovered
Total number of approved domain+geo pairs discovered
{ "runs": [ { … } ] }
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/reports/request-privacy/trends/{trendName}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.observepoint.com/v3/web-audits/107239/reports/request-privacy/trends/{trendName}?days=1' \
-H 'Authorization: YOUR_API_KEY_HERE'
Request Privacy specific trend values
Date-time in RFC3339 profile ISO 8601 format with the following additional restrictions:
- An uppercase T must separate the date and time portions.
- An uppercase Z must denote that a numeric time zone offset isn't present.
In general, these timestamp requirements are the same in AWS Step Functions - Choice Rules
{ "runs": [ { … } ] }
Filters applicable to Request Privacy report. countryCode
filter is not abided by this endpoint.
broken
- initial or final URL arebroken
,good
- initial URL isgood
orredirect
and final URL isgood
Page load time in milliseconds. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Page size in bytes. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Number of redirects for a page. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Use in filtering purposes is DEPRECATED in favour of ConsentCategoryId
! Snapshot Id of consent category attached to this run
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/runs/{runId}/reports/request-privacy/locations
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/request-privacy/locations \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"finalPageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"pageTitle": {
"filterType": "contains",
"filterValue": "ObserveP"
},
"initialPageStatusCode": {
"filterType": "specific",
"negated": true
},
"finalPageStatusCode": {
"filterType": "specific",
"negated": true
},
"combinedPageStatusCode": "broken",
"pageLoadTime": {
"min": 0,
"max": 0
},
"pageSize": {
"min": 0,
"max": 0
},
"redirectCount": {
"min": 0,
"max": 0
},
"hasBrokenLinks": true,
"pageUrlMatchingAuditFilterConfiguration": true,
"requestDomain": "example.com",
"consentCategoryId": 3301,
"consentCategorySnapshotId": 33010,
"consentCategoryComplianceStatus": "approved",
"countryCode": "US"
}'
{ "locations": [ { … } ] }
Filters applicable to Request Privacy report
broken
- initial or final URL arebroken
,good
- initial URL isgood
orredirect
and final URL isgood
Page load time in milliseconds. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Page size in bytes. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Number of redirects for a page. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Use in filtering purposes is DEPRECATED in favour of ConsentCategoryId
! Snapshot Id of consent category attached to this run
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/runs/{runId}/reports/request-privacy/compliance
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/request-privacy/compliance?page=0&size=100&sortBy=compliance_status&sortDesc=false' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"finalPageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"pageTitle": {
"filterType": "contains",
"filterValue": "ObserveP"
},
"initialPageStatusCode": {
"filterType": "specific",
"negated": true
},
"finalPageStatusCode": {
"filterType": "specific",
"negated": true
},
"combinedPageStatusCode": "broken",
"pageLoadTime": {
"min": 0,
"max": 0
},
"pageSize": {
"min": 0,
"max": 0
},
"redirectCount": {
"min": 0,
"max": 0
},
"hasBrokenLinks": true,
"pageUrlMatchingAuditFilterConfiguration": true,
"requestDomain": "example.com",
"consentCategoryId": 3301,
"consentCategorySnapshotId": 33010,
"consentCategoryComplianceStatus": "approved",
"countryCode": "US"
}'
Request Privacy compliance data
Common metadata for iterable
Total number of items available from all result pages combined
Page size - number of items per result page configured by size
query parameter or default page size
Use in filtering purposes is DEPRECATED in favour of ConsentCategoryId
! Snapshot Id of consent category attached to this run
Name of consent category item (tag, cookie, domain, geo) belongs to
{ "metadata": { "pagination": { … } }, "requests": [ { … } ] }
Filters applicable to Request Privacy report
broken
- initial or final URL arebroken
,good
- initial URL isgood
orredirect
and final URL isgood
Page load time in milliseconds. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Page size in bytes. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Number of redirects for a page. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Use in filtering purposes is DEPRECATED in favour of ConsentCategoryId
! Snapshot Id of consent category attached to this run
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/runs/{runId}/reports/request-privacy/pages
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/request-privacy/pages?page=0&size=50&sortBy=page_url&sortDesc=false' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"finalPageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"pageTitle": {
"filterType": "contains",
"filterValue": "ObserveP"
},
"initialPageStatusCode": {
"filterType": "specific",
"negated": true
},
"finalPageStatusCode": {
"filterType": "specific",
"negated": true
},
"combinedPageStatusCode": "broken",
"pageLoadTime": {
"min": 0,
"max": 0
},
"pageSize": {
"min": 0,
"max": 0
},
"redirectCount": {
"min": 0,
"max": 0
},
"hasBrokenLinks": true,
"pageUrlMatchingAuditFilterConfiguration": true,
"requestDomain": "example.com",
"consentCategoryId": 3301,
"consentCategorySnapshotId": 33010,
"consentCategoryComplianceStatus": "approved",
"countryCode": "US"
}'
{ "metadata": { "pagination": { … } }, "pages": [ { … } ] }
Filters applicable to Request Privacy report
broken
- initial or final URL arebroken
,good
- initial URL isgood
orredirect
and final URL isgood
Page load time in milliseconds. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Page size in bytes. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
Number of redirects for a page. Should have min
and/or max
properties defined. min
is inclusive and max
is exclusive. min
should be less than max
.
- ObservePoint Production API
https://api.observepoint.com/v3/web-audits/{auditId}/runs/{runId}/reports/request-privacy/request-pages
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://api.observepoint.com/v3/web-audits/107239/runs/33010/reports/request-privacy/request-pages?page=0&size=50&sortBy=page_url&sortDesc=false' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"pageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"finalPageUrl": {
"filterType": "contains",
"filterValue": "string",
"negated": false
},
"pageTitle": {
"filterType": "contains",
"filterValue": "ObserveP"
},
"initialPageStatusCode": {
"filterType": "specific",
"negated": true
},
"finalPageStatusCode": {
"filterType": "specific",
"negated": true
},
"combinedPageStatusCode": "broken",
"pageLoadTime": {
"min": 0,
"max": 0
},
"pageSize": {
"min": 0,
"max": 0
},
"redirectCount": {
"min": 0,
"max": 0
},
"hasBrokenLinks": true,
"pageUrlMatchingAuditFilterConfiguration": true,
"requestDomain": "example.com",
"countryCode": "US"
}'
{ "metadata": { "pagination": { … } }, "pages": [ { … } ] }