Anura Docs

Anura Reporting API

The Anura Reporting API is the most advanced method to access report data from Anura Script and Anura Direct outside of our dashboard. With the Anura Reporting API, you can:

• Build custom reports with the metrics you want to know more about.
• Automate complex analysis.
• Integrate or layer Anura Reporting data in conjunction with other reporting or backend data.

Anura Reporting API - Usage

The Anura Reporting API allows you to access Anura reports data from within your own applications. To get started, you will need to create a reporting API token.

Anura Reporting API - Usage - API Tokens

You can create and manage Reporting API tokens by logging into the Anura Dashboard and going to the "Reporting API" token management interface, located within the "Account" section of the navigation menu, or by visiting https://dashboard.anura.io/v1/account/api.

Create Reporting API Token Form Fields

Managing Reporting API Tokens

• Reporting API tokens may be temporarily enabled or disabled.
• Reporting API tokens may be permanently removed.
• As of June 06, 2019, Reporting API tokens are bound to the user account that created them. If the creating user's account is disabled, all of their corresponding tokens will also be disabled.

Anura Reporting API - Usage - Performing Requests

Requests to the Anura Reporting API are made over secure connections using the HTTP POST method.

Things to Remember...

• POST parameter string values must be URL encoded.
• Drilling into metric reporting data will require optional parameters to be set.
• Some drilldown parameters require that a parent parameter be applied first.
• A daily breakdown will be returned when all applicable drilldown parameters have been applied.
• Instance, source, and campaign interface parameters may be applied at any time.
• "All Instances", "All Sources", and "All Campaigns" are acceptable interface values where applicable.
• Anura reporting is based on the Coordinated Universal Time (UTC) time zone.

Limitations

Date specific API requests are limited to a 7-day rolling time frame with the exception of "Overview" endpoints, which have a 31-day rolling time frame. If your request falls outside of the time frame limit, a HTTP status code of "400 - Bad Request" will be returned. See Reporting API: Handling Responses for more details.

Anura Reporting API - Usage - Handling Responses

Responses from the Anura Reporting API are JSON encoded and typically returned within milliseconds. However, in cases where vast amounts of unique data exist, responses may take several seconds or minutes. Please be sure to adjust any timeouts to wait until the response has been returned.

There are 5 distinct HTTP status response codes that may be encountered when performing requests. The following table provides HTTP status codes with a brief description of their meaning:

Things to Remember...

• String response values are returned URL encoded.
• Script and Direct "instance" table values are returned as a URL encoded object containing both the "id" and "name" of the instance.
• Script's "adblocker" value may return "null" when ad blocker detection is not enabled for your instance.

Anura Reporting API - Interface Endpoints

The following Interface data endpoints are available in the current version of the Anura Reporting API.

Anura Reporting API - Interface Endpoints - Instances

The Interface: Instances endpoint will allow you to retrieve, or search, instances associated with your Reporting API token.

Parameters

Example Response

{
    "instances": [
        {
            "id": "All+Instances",
            "name": "All+Instances"
            "status": 1
        },
        {
            "id": 1234567890,
            "name": "yourInstanceName"
            "status": 1
        }
    ],
    "query": {
        "name": false,
        "all": true,
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Interface Endpoints - Sources

The Interface: Sources endpoint will allow you to retrieve, or search, sources applicable to the supplied POST parameters.

Parameters

Example Response

{
    "sources": [
        "All+Sources",
        "yourSourceTrackingId"
    ],
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "all": true,
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Interface Endpoints - Campaigns

The Interface: Campaigns endpoint will allow you to retrieve, or search, campaigns applicable to the supplied POST parameters.

Parameters

Example Response

{
    "campaigns": [
        "All+Campaigns",
        "yourCampaignTrackingId"
    ],
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "all": true,
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints

The following Script data reporting endpoints are available in the current version of the Anura Reporting API.

Anura Reporting API - Script Endpoints - Overview

The Script: Overview endpoint will allow you to retrieve total counts of data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "chart": false
    }
}

Anura Reporting API - Script Endpoints - Sessions

The Script: Sessions endpoint will allow you to retrieve a table of session specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Instance",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            "%7B%22id%22%3A%22All+Instances%22%2C%22name%22%3A%22All+Instances%22%7D",
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "%7B%22id%22%3A1234567890%2C%22name%22%3A%22yourInstanceName%22%7D",
                25,
                23,
                10,
                5,
                8,
                2,
                1
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 1,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Browsers

The Script: Browsers endpoint will allow you to retrieve a table of web browser specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Browser",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "Chrome",
                18,
                17,
                7,
                4,
                6,
                2,
                1
            ],
            [
                "Firefox",
                7,
                6,
                3,
                1,
                2,
                0,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "browser": false,
        "browser_version": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Operating Systems

The Script: Operating Systems endpoint will allow you to retrieve a table of operating system specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "OS",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "Windows",
                23,
                21,
                8,
                5,
                8,
                0,
                1
            ],
            [
                "Android",
                2,
                2,
                2,
                0,
                0,
                2,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "os": false,
        "os_version": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Devices

The Script: Devices endpoint will allow you to retrieve a table of device specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Manufacturer",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "%28non-identifiable%29",
                23,
                21,
                8,
                5,
                8,
                0,
                1
            ],
            [
                "Samsung",
                2,
                2,
                2,
                0,
                0,
                2,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "manufacturer": false,
        "model": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Device Types

The Script: Device Types endpoint will allow you to retrieve a table of device type specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Type",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "desktop",
                23,
                21,
                8,
                5,
                8,
                0,
                1
            ],
            [
                "mobile:smart",
                2,
                2,
                2,
                0,
                0,
                2,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "type": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Geography

The Script: Geography endpoint will allow you to retrieve a table of geographical specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Country",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "United+States",
                18,
                17,
                5,
                4,
                8,
                2,
                0
            ],
            [
                "Canada",
                7,
                6,
                5,
                1,
                0,
                0,
                1
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "country": false,
        "region": false,
        "city": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Languages

The Script: Languages endpoint will allow you to retrieve a table of language specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Language",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "en-us",
                17,
                5,
                4,
                8,
                2,
                0
            ],
            [
                "en-ca",
                6,
                5,
                1,
                0,
                0,
                1
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "language": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Networks

The Script: Networks endpoint will allow you to retrieve a table of network specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Network",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "Comcast+Cable+Communications%2C+LLC",
                18,
                17,
                5,
                4,
                8,
                2,
                0
            ],
            [
                "Rogers+Communications+Canada+Inc.",
                7,
                6,
                5,
                1,
                0,
                0,
                1
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "network": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Connections

The Script: Connections endpoint will allow you to retrieve a table of connection specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "drops": 2,
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Connection",
            "Requests",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            25,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "Cable%2FDSL",
                23,
                21,
                8,
                5,
                8,
                0,
                1
            ],
            [
                "Cellular",
                2,
                2,
                2,
                0,
                0,
                2,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "connection": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Pages

The Script: Pages endpoint will allow you to retrieve a table of page specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Host",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "www.anura.io",
                13,
                7,
                2,
                4,
                1,
                1
            ],
            [
                "docs.anura.io",
                10,
                3,
                3,
                4,
                1,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "host": false,
        "path": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Script Endpoints - Referrers

The Script: Referrers endpoint will allow you to retrieve a table of referrer specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "good": 10,
        "warning": 5,
        "bad": 8,
        "mobile": 2,
        "adblocker": 1
    },
    "table": {
        "headers": [
            "Host",
            "Responses",
            "Good",
            "Warning",
            "Bad",
            "Mobile",
            "Ad+Blocker"
        ],
        "all": [
            false,
            23,
            10,
            5,
            8,
            2,
            1
        ],
        "rows": [
            [
                "%28direct%29",
                14,
                2,
                3,
                9,
                1,
                1
            ],
            [
                "www.google.com",
                9,
                8,
                1,
                0,
                1,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "host": false,
        "path": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints

The following Direct data reporting endpoints are available in the current version of the Anura Reporting API.

Anura Reporting API - Direct Endpoints - Overview

The Direct: Overview endpoint will allow you to retrieve total counts of data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "chart": false
    }
}

Anura Reporting API - Direct Endpoints - Sessions

The Direct: Sessions endpoint will allow you to retrieve a table of session specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Instance",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            "%7B%22id%22%3A%22All+Instances%22%2C%22name%22%3A%22All+Instances%22%7D",
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "%7B%22id%22%3A1234567890%2C%22name%22%3A%22yourInstanceName%22%7D",
                25,
                17,
                8,
                2
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 1,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Browsers

The Direct: Browsers endpoint will allow you to retrieve a table of web browser specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Browser",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "Chrome",
                18,
                14,
                4,
                2
            ],
            [
                "Firefox",
                7,
                3,
                4,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "browser": false,
        "browser_version": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Operating Systems

The Direct: Operating Systems endpoint will allow you to retrieve a table of operating system specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "OS",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "Windows",
                23,
                15,
                8,
                0
            ],
            [
                "Android",
                2,
                2,
                0,
                2
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "os": false,
        "os_version": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Devices

The Direct: Devices endpoint will allow you to retrieve a table of device specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Manufacturer",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "%28non-identifiable%29",
                23,
                15,
                8,
                0
            ],
            [
                "Samsung",
                2,
                2,
                0,
                2
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "manufacturer": false,
        "model": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Device Types

The Direct: Device Types endpoint will allow you to retrieve a table of device type specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Type",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "desktop",
                23,
                15,
                8,
                0
            ],
            [
                "mobile:smart",
                2,
                2,
                0,
                2
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "type": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Geography

The Direct: Geography endpoint will allow you to retrieve a table of geographical specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Country",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "United+States",
                16,
                11,
                5,
                2
            ],
            [
                "Canada",
                9,
                6,
                3,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "country": false,
        "region": false,
        "city": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Networks

The Direct: Networks endpoint will allow you to retrieve a table of network specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Network",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "Comcast+Cable+Communications%2C+LLC",
                16,
                11,
                5,
                2
            ],
            [
                "Rogers+Communications+Canada+Inc.",
                9,
                6,
                3,
                0
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "network": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Direct Endpoints - Connections

The Direct: Connections endpoint will allow you to retrieve a table of connection specific data applicable to the supplied POST parameters.

Parameters

Example Response

{
    "total": {
        "nonsuspect": 17,
        "suspect": 8,
        "mobile": 2
    },
    "table": {
        "headers": [
            "Connection",
            "Requests",
            "Non-Suspect",
            "Suspect",
            "Mobile"
        ],
        "all": [
            false,
            25,
            17,
            8,
            2
        ],
        "rows": [
            [
                "Cable%2FDSL",
                23,
                15,
                8,
                0
            ],
            [
                "Cellular",
                2,
                2,
                0,
                2
            ]
        ]
    },
    "query": {
        "start": 20180101,
        "end": 20180101,
        "instance": false,
        "source": false,
        "campaign": false,
        "connection": false,
        "chart": false,
        "rates": false,
        "rules": false,
        "search": false,
        "sort": "1:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1
    }
}

Anura Reporting API - Raw Data Endpoints

The following Raw Data endpoints are available in the current version of the Anura Reporting API.

Anura Reporting API - Raw Data Endpoints - Table

The Raw Data: Table endpoint will allow you to retrieve, or search, a list of self-generated reports applicable to the supplied POST parameters.

Parameters

Example Response

{
    "processing": {
        "limits": {
            "minutes_total": 900,
            "api_concurrent": 1,
            "dashboard_concurrent": 2,
            "minutes_available": 888
        }
    },
    "table": {
        "rows": [
            {
                "id": "kuDZdF6v",
                "name": "Anura+Raw+Response+Report+20220924",
                "instance": "yourInstanceName",
                "type": "Response",
                "requested": "2022-09-24T13:22:31+00:00",
                "created": null,
                "failed": null,
                "timed_out": null,
                "cancelled": null,
                "status": "In Progress",
                "expires": "2022-10-25T00:00:00+00:00"
            },
            {
                "id": "JpTxDnu4",
                "name": "Anura+Raw+Request+Report+20220924",
                "instance": "yourInstanceName",
                "type": "Request",
                "requested": "2022-09-24T13:16:19+00:00",
                "created": "2022-09-24T13:17:28+00:00",
                "failed": null,
                "timed_out": null,
                "cancelled": null,
                "status": "Ready",
                "expires": "2022-10-25T00:00:00+00:00"
            }
        ]
    },
    "query": {
        "search": false,
        "sort": "3:desc",
        "page": 1,
        "limit": 20,
        "results": 2,
        "pages": 1,
        "processing_usage": false
    }
}

Anura Reporting API - Raw Data Endpoints - Report

The Raw Data: Report endpoint will allow you to retrieve detailed, report specific information applicable to the supplied POST parameters.

Parameters

Example Response

{
    "id": "kuDZdF6v",
    "type": "Response",
    "name": "Anura+Raw+Response+Report+20220924",
    "start": 20220918,
    "end": 20220924,
    "instance_id": 1234567890,
    "instance_name": "yourInstanceName",
    "columns": {
        "standard": [
            "source",
            "campaign",
            "response_id",
            "result",
            "remote_address",
            "network",
            "country",
            "region",
            "city",
            "user_agent",
            "browser_name",
            "browser_version",
            "os_name",
            "os_version",
            "device_type"
        ],
        "additional": null
    },
    "filters": null,
    "send_email": true,
    "requested": "2022-09-24T13:22:31+00:00",
    "file_name": "anura-response-yourInstanceName-20220918-20220924-1664025751-f84312.zip",
    "file_size": 208472,
    "rows": 5721,
    "created": "2022-09-24T13:31:46+00:00",
    "failed": null,
    "timed_out": null,
    "cancelled": null,
    "alerted": "2022-09-24T13:31:46+00:00",
    "status": "Ready",
    "processing_minutes": 10,
    "expires": "2022-10-25T00:00:00+00:00"
}

Anura Reporting API - Raw Data Endpoints - Request

The Raw Data: Request endpoint will allow you to generate a new report applicable to the supplied POST parameters.

Parameters

Limitations

Please be aware of the following processing limitations when requesting Raw Data reports:

• Accounts are limited to 360 total minutes of data processing per day - across all users.
• Users may request up to two concurrent reports at a time via the Anura Dashboard interface.
• Users may only request one report at a time via the Anura API.
• Processing time is rounded up to the minute.

Data processing limitations are default values and can be modified. Talk to support if you're encountering issues with the default limitations.

Standard Data Columns

Filter Objects

A filter is an object consisting of a column, operator, and value, that is used to narrow the number of results in a report. Multiple filters may be applied to a request; however, a column may only be filtered once.

"filters": [
    {
        "column": "source",
        "operator": "conatins",
        "value": "hello"
    }
]

The above example illustrates a filter object on the source column where the value contains "hello".

Filter Operators

Operators are the comparison mechanism used when narrowing report results. Most operators can be used against any column, however, there are a few special cases to be aware of. Available operators and their special cases can be found in the following tables.

Special Case Operators

Example Request

{
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiIxMjMiLCJpYXQiOjE2NjE5OTIwODAsImp0aSI6ImlPYVNOQW10UmhZU3l2MXQ5eDkiLCJhdWQiOiIwbVglMkZSJTJCTWdBS2xteSIsInRrbiI6ImFwaSJ9.SC8PtaQetBwGBu56J0yyUtqVEL",
    "type": "response",
    "instance": 1234567890,
    "start": 20220918,
    "end": 20220924,
    "standard": [
        "source",
        "campaign",
        "response_id",
        "result",
        "remote_address",
        "network",
        "country",
        "region",
        "city",
        "user_agent",
        "browser_name",
        "browser_version",
        "os_name",
        "os_version",
        "device_type"
    ],
    "name": "My%20First%20Raw%20Data%20Report",
    "additional": [
        1,
        3,
        5
    ],
    "filters": [
        {
            "column": "source",
            "operator": "contains",
            "value": "hello"
        },
        {
            "column": "campaign",
            "operator": "contains",
            "value": "world"
        }
    ],
    "send_email": false
}

Example Response

{
    "success": true,
    "message": "Your+raw+data+report+has+been+requested",
    "feedback": {
        "pass": {},
        "fail": {}
    },
    "id": "mnUeFVP0"
}

Anura Reporting API - Raw Data Endpoints - Cancel

The Raw Data: Cancel endpoint will allow you to cancel "In Progress" report requests applicable to the supplied POST parameters.

Parameters

Example Response

{
    "success": true,
    "message": "Your+raw+data+report+request+has+been+cancelled",
    "feedback": {
        "pass": {},
        "fail": {}
    }
}

Anura Reporting API - Raw Data Endpoints - Download

The Raw Data: Download endpoint returns a temporary URL that will allow you to download a self-generated report applicable to the supplied POST parameters.

Parameters

Example Response

{
    "url": "https%3A%2F%2Fanura-reports.s3.amazonaws.com%2Fraw%2F1234567890%2Fresponse%2Fanura-response-yourInstanceName-20220918-20220924-1664025751-f84312.zip"
}

Anura Reporting API - Raw Data Endpoints - Remove

The Raw Data: Remove endpoint will allow you to remove self-generated reports applicable to the supplied POST parameters.

Parameters

Example Response

{
    "success": true,
    "message": "%22Anura+Raw+Direct+Report+20220924%22+has+been+removed",
    "feedback": {
        "pass": {},
        "fail": {}
    }
}