Pages

Page endpoints use flat reporting query parameters: GET https://data.goodmetrics.io/{gmID}/events/pages/{resource}?start={start}&end={end}.

Example:

curl

curl "https://data.goodmetrics.io/{gmID}/events/pages/all-pages?start=1771872000&end=1772476799&page=1&limit=10&page_contains=%2Fpricing&sort_by=pageViews&dir=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Node

const gmID = '{gmID}';
const apiKey = 'YOUR_API_KEY';
const params = new URLSearchParams({
  "start": "1771872000",
  "end": "1772476799",
  "page": "1",
  "limit": "10",
  "page_contains": "/pricing",
  "sort_by": "pageViews",
  "dir": "desc"
});

const response = await fetch(`https://data.goodmetrics.io/${gmID}/events/pages/all-pages?${params}`, {
  headers: {
    Authorization: `Bearer ${apiKey}`
  }
});

console.log(await response.json());

Python

import json
import urllib.parse
import urllib.request

gm_id = "{gmID}"
api_key = "YOUR_API_KEY"
params = urllib.parse.urlencode({
    "start": "1771872000",
    "end": "1772476799",
    "page": "1",
    "limit": "10",
    "page_contains": "/pricing",
    "sort_by": "pageViews",
    "dir": "desc"
})

request = urllib.request.Request(
    f"https://data.goodmetrics.io/{gm_id}/events/pages/all-pages?{params}",
    headers={"Authorization": f"Bearer {api_key}"},
)

with urllib.request.urlopen(request) as response:
    print(json.load(response))

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

class GoodMetricsExample {
  public static void main(String[] args) throws Exception {
    var gmID = "{gmID}";
    var apiKey = "YOUR_API_KEY";
    var url = "https://data.goodmetrics.io/" + gmID + "/events/pages/all-pages?start=1771872000&end=1772476799&page=1&limit=10&page_contains=%2Fpricing&sort_by=pageViews&dir=desc";

    var request = HttpRequest.newBuilder()
      .uri(URI.create(url))
      .header("Authorization", "Bearer " + apiKey)
      .GET()
      .build();

    var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

C#

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;

var gmID = "{gmID}";
var apiKey = "YOUR_API_KEY";
var query = new Dictionary<string, string>
{
  ["start"] = "1771872000",
  ["end"] = "1772476799",
  ["page"] = "1",
  ["limit"] = "10",
  ["page_contains"] = "/pricing",
  ["sort_by"] = "pageViews",
  ["dir"] = "desc"
};
var queryString = string.Join("&", query.Select(parameter =>
  $"{Uri.EscapeDataString(parameter.Key)}={Uri.EscapeDataString(parameter.Value)}"));

var url = $"https://data.goodmetrics.io/{gmID}/events/pages/all-pages?{queryString}";

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, url);
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php
$gmID = "{gmID}";
$apiKey = "YOUR_API_KEY";
$params = http_build_query([
    "start" => "1771872000",
    "end" => "1772476799",
    "page" => "1",
    "limit" => "10",
    "page_contains" => "/pricing",
    "sort_by" => "pageViews",
    "dir" => "desc"
]);

$url = "https://data.goodmetrics.io/{$gmID}/events/pages/all-pages?{$params}";

$context = stream_context_create([
    "http" => [
        "method" => "GET",
        "header" => "Authorization: Bearer {$apiKey}\r\n",
    ],
]);

$response = file_get_contents($url, false, $context);
echo $response;

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "net/url"
)

func main() {
  gmID := "{gmID}"
  apiKey := "YOUR_API_KEY"

  params := url.Values{}
  params.Set("start", "1771872000")
  params.Set("end", "1772476799")
  params.Set("page", "1")
  params.Set("limit", "10")
  params.Set("page_contains", "/pricing")
  params.Set("sort_by", "pageViews")
  params.Set("dir", "desc")

  request, _ := http.NewRequest(
    "GET",
    "https://data.goodmetrics.io/"+gmID+"/events/pages/all-pages?"+params.Encode(),
    nil,
  )
  request.Header.Set("Authorization", "Bearer "+apiKey)

  response, _ := http.DefaultClient.Do(request)
  defer response.Body.Close()

  body, _ := io.ReadAll(response.Body)
  fmt.Println(string(body))
}

Overview endpoints

Endpoint	Description
GET /{gmID}/events/pages/overview/top-pages	Top page overview.
GET /{gmID}/events/pages/overview/landing-pages	Landing page overview.
GET /{gmID}/events/pages/overview/exit-pages	Exit page overview.
GET /{gmID}/events/pages/overview/initial-landing-pages	Initial landing page overview.

Table endpoints

Endpoint	Alignment key
GET /{gmID}/events/pages/all-pages	page
GET /{gmID}/events/pages/landing-pages	page
GET /{gmID}/events/pages/exit-pages	page
GET /{gmID}/events/pages/initial-landing-pages	page

Page table rows commonly include page, subdomain, pageViews, entrances, exits, exitRate, avgTimeOnPage, eventCompletions, eventValue, and eventConversionRate.

See Common Recipes for more request examples.