How to use WebAnalytics API – FrontEndDataRetriever.QueryData

This post is a contribution from Jaishree Thiyagarajan, an engineer with the SharePoint Developer Support team.

To use WebAnalytics API, first we need to add reference to Microsoft.Office.Server.WebAnalytics.dll and Microsoft.Office.Server.WebAnalytics.UI.dll.  These DLLs can be located in GAC (C:\Windows\Assembly\GAC_MSIL\).

The WebAnalytics DB (Report DB) has many Table-Valued-functions, which we can leverage programmatically through FrontEndDataRetriever.QueryData.

Check out the example given below.  I’ve used “fn_WA_GetNumberOfClickthroughs”, this function will retrieve the number of hits per URL.

List of available functions can be found in this article.

Sample below.

    using (SPSite site = new SPSite("http://siteURL/"))
        AggregationContext aggregationContext = AggregationContext.GetContext(site);
        if (aggregationContext != null)
            List<ViewParameterValue> viewParamsList = new List<ViewParameterValue>();
            viewParamsList.Add(new ViewParameterValue("StartDateId", DateTimeToDateId(DateTime.UtcNow.AddMonths(-6))));
            viewParamsList.Add(new ViewParameterValue("EndDateId", DateTimeToDateId(DateTime.UtcNow)));
            viewParamsList.Add(new ViewParameterValue("GroupByPageId", true));
            DataPacket dataPacket = FrontEndDataRetriever.QueryData(aggregationContext, null, "fn_WA_GetNumberOfClickthroughs", viewParamsList, null, GetSortOrder("Frequency", OrderType.Descending), 1, 25000, false);
            if (dataPacket.DataTable != null)
                //Datatable manipulation
                //No datatable available
catch (Exception ex)
Comments (7)

  1. Anonymous says:


    Could you please let me know what is the error being returned?

    I tested your code, it returns the expected results.

    Also, do you see any data being returned in UI (Site Actions -> Site settings ->  Site Web Analytics reports )?

  2. Anon says:

    The sample does not include a definition for DateTimeToDateId or GetSortOrder. I tried to implement those myself, but making the query returns an error.

    The implementation is as below. What am i doing wrong?

    private List<SortOrder> GetSortOrder(string frequency, OrderType @descending)


               List<SortOrder> sortOrders = new List<SortOrder>();

               sortOrders.Add(new SortOrder(frequency, descending));

               return sortOrders;


           private int DateTimeToDateId(DateTime dateTime)


               return (((dateTime.Year*100) + dateTime.Month)*100 + dateTime.Day);


  3. ivan says:

    I have an example on how to get the Summary Report using PowerShell here:…/Get-SharePoint-Web-19cd2137

  4. AB says:

    Could you help me in getting the Condition parameter filled. ie., I need to apply logged in user loginname as a condition to Condtion parameter(wherecondition).  

    FrontEndDataRetriever.QueryData(aggregationContext, null, "fn_WA_GetNumberOfClickthroughs", viewParamsList, NULL, GetSortOrder("Frequency", OrderType.Descending), 1, 25000, false);

    Currently it is null could you help me to implement the condition or some sample code which explains this implementation.(Condition Class).

  5. Abed says:

    Here are the definitions of DateTimeToDateId and GetSortOrder:

    public static int DateTimeToDateId(DateTime dt)
    if (string.IsNullOrEmpty(dt.ToString()))
    return 0;
    return int.Parse(dt.ToString("yyyyMMdd", CultureInfo.InvariantCulture), CultureInfo.InvariantCulture);

    private static List GetSortOrder(string sortColumn, OrderType order)
    List list = new List();
    SortOrder item = null;
    item = new SortOrder(sortColumn, order);
    return list;

  6. Kevin Hirst says:

    Where is this DLL located? It’s on the Sharepoint server in the GAC, but I installed the 2010 SDK and I didn’t get it.

  7. Kevin Hirst says:

    I.E. it doesn’t seem to come with the SDK. Can I get it without installing SP 2010 specifically?

Skip to main content