Speeda Ranking — Endpoints

Base URL: https://datafeed.ub-speeda.com/japan/ranking/v1

---

Company Ranking Endpoints

Get Company Rankings

Returns Japan listed company rankings with page views and engagement metrics for a specified date range.

GET /companies

Required Scopes: speeda-ranking.companies

Parameters

Name	In	Type	Required	Default	Description
start_datetime	query	string (date-time)	Yes	—	Start datetime (yyyy-MM-dd'T'HH:mm:ss)
end_datetime	query	string (date-time)	Yes	—	End datetime (yyyy-MM-dd'T'HH:mm:ss)
page	query	integer	No	1	Page number (1-indexed)
page_size	query	integer	No	25	Items per page

Example Request

cURL

curl -X GET "https://datafeed.ub-speeda.com/japan/ranking/v1/companies?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25" \
  -H "Authorization: Bearer {access_token}"

Python

import requests
response = requests.get(
    "https://datafeed.ub-speeda.com/japan/ranking/v1/companies",
    headers={"Authorization": "Bearer {access_token}"},
    params={"start_datetime": "2024-01-01T00:00:00", "end_datetime": "2024-01-31T23:00:00", "page": 1, "page_size": 25},
)
print(response.json())

Java

import java.net.URI;
import java.net.http.*;

HttpResponse<String> response = HttpClient.newHttpClient().send(
    HttpRequest.newBuilder()
        .uri(URI.create("https://datafeed.ub-speeda.com/japan/ranking/v1/companies?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25"))
        .header("Authorization", "Bearer {access_token}")
        .GET()
        .build(),
    HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());

Node.js

const response = await fetch(
  "https://datafeed.ub-speeda.com/japan/ranking/v1/companies?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25",
  { headers: { Authorization: "Bearer {access_token}" } }
);
console.log(await response.json());

Kotlin

import java.net.URI
import java.net.http.*

val response = HttpClient.newHttpClient().send(
    HttpRequest.newBuilder()
        .uri(URI.create("https://datafeed.ub-speeda.com/japan/ranking/v1/companies?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25"))
        .header("Authorization", "Bearer {access_token}")
        .GET()
        .build(),
    HttpResponse.BodyHandlers.ofString()
)
println(response.body())

Go

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

req, _ := http.NewRequest("GET", "https://datafeed.ub-speeda.com/japan/ranking/v1/companies?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25", nil)
req.Header.Set("Authorization", "Bearer {access_token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

Example Response

{
  "data": [
    {
      "companyName": "Toyota Motor Corporation",
      "tickerSymbol": "7203",
      "headquarters": "Aichi, Japan",
      "totalPageViews": 125,
      "totalUniquePageViews": 45,
      "engagementTime": {
        "avg": 3.09,
        "min": 1.5,
        "max": 5.2
      }
    },
    {
      "companyName": "Sony Group Corporation",
      "tickerSymbol": "6758",
      "headquarters": "Tokyo, Japan",
      "totalPageViews": 98,
      "totalUniquePageViews": 37,
      "engagementTime": {
        "avg": 2.45,
        "min": 0.8,
        "max": 4.1
      }
    }
  ],
  "page": 1,
  "pageSize": 25,
  "total": 1500
}

---

Get Company Page Rankings

Returns Japan listed company rankings with a per-page-type breakdown of page views and engagement metrics for a specified date range.

GET /company-pages

Required Scopes: speeda-ranking.company-pages

Parameters

Name	In	Type	Required	Default	Description
start_datetime	query	string (date-time)	Yes	—	Start datetime (yyyy-MM-dd'T'HH:mm:ss)
end_datetime	query	string (date-time)	Yes	—	End datetime (yyyy-MM-dd'T'HH:mm:ss)
page	query	integer	No	1	Page number (1-indexed)
page_size	query	integer	No	25	Items per page

Example Request

cURL

curl -X GET "https://datafeed.ub-speeda.com/japan/ranking/v1/company-pages?start_datetime=2026-01-01T00:00:00&end_datetime=2026-01-31T23:00:00&page=1&page_size=25" \
  -H "Authorization: Bearer {access_token}"

Python

import requests
response = requests.get(
    "https://datafeed.ub-speeda.com/japan/ranking/v1/company-pages",
    headers={"Authorization": "Bearer {access_token}"},
    params={"start_datetime": "2026-01-01T00:00:00", "end_datetime": "2026-01-31T23:00:00", "page": 1, "page_size": 25},
)
print(response.json())

Java

import java.net.URI;
import java.net.http.*;

HttpResponse<String> response = HttpClient.newHttpClient().send(
    HttpRequest.newBuilder()
        .uri(URI.create("https://datafeed.ub-speeda.com/japan/ranking/v1/company-pages?start_datetime=2026-01-01T00:00:00&end_datetime=2026-01-31T23:00:00&page=1&page_size=25"))
        .header("Authorization", "Bearer {access_token}")
        .GET()
        .build(),
    HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());

Node.js

const response = await fetch(
  "https://datafeed.ub-speeda.com/japan/ranking/v1/company-pages?start_datetime=2026-01-01T00:00:00&end_datetime=2026-01-31T23:00:00&page=1&page_size=25",
  { headers: { Authorization: "Bearer {access_token}" } }
);
console.log(await response.json());

Kotlin

import java.net.URI
import java.net.http.*

val response = HttpClient.newHttpClient().send(
    HttpRequest.newBuilder()
        .uri(URI.create("https://datafeed.ub-speeda.com/japan/ranking/v1/company-pages?start_datetime=2026-01-01T00:00:00&end_datetime=2026-01-31T23:00:00&page=1&page_size=25"))
        .header("Authorization", "Bearer {access_token}")
        .GET()
        .build(),
    HttpResponse.BodyHandlers.ofString()
)
println(response.body())

Go

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

req, _ := http.NewRequest("GET", "https://datafeed.ub-speeda.com/japan/ranking/v1/company-pages?start_datetime=2026-01-01T00:00:00&end_datetime=2026-01-31T23:00:00&page=1&page_size=25", nil)
req.Header.Set("Authorization", "Bearer {access_token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

Example Response

{
  "data": [
    {
      "companyName": "Toyota Motor Corporation",
      "tickerSymbol": "7203",
      "headquarters": "Aichi, Japan",
      "totalPageViews": 500,
      "totalUniquePageViews": 200,
      "engagementTime": {
        "avg": 3.09,
        "min": 1.5,
        "max": 5.2
      },
      "pages": {
        "OVERVIEW": {
          "totalPageViews": 100,
          "totalUniquePageViews": 50,
          "engagementTime": {
            "avg": 5.2,
            "min": 1.0,
            "max": 15.3
          }
        },
        "FINANCIAL_RESULTS": {
          "totalPageViews": 80,
          "totalUniquePageViews": 30,
          "engagementTime": null
        },
        "FUNCTIONALITY": null
      }
    }
  ],
  "page": 1,
  "pageSize": 25,
  "total": 1500
}

note

The pages field is a map keyed by page type. A null value indicates zero stats for that page type. Possible keys: OVERVIEW, COMPETITOR_OVERVIEW, SEGMENT_COMPARISON, NEWS, MA, SHAREHOLDERS, EXECUTIVES_CHART, AFFILIATES, STOCK_PRICES, INVESTOR_RELATIONS, STATS, TECHNOLOGY, FINANCIAL_RESULTS, SEGMENT, KPI_CHARTS, ESTIMATES, BETA, FUNCTIONALITY.

---

Industry Ranking Endpoints

Get Industry Rankings

Returns industry rankings with page views and engagement metrics for a specified date range.

GET /industries

Required Scopes: speeda-ranking.industries

Parameters

Name	In	Type	Required	Default	Description
start_datetime	query	string (date-time)	Yes	—	Start datetime (yyyy-MM-dd'T'HH:mm:ss)
end_datetime	query	string (date-time)	Yes	—	End datetime (yyyy-MM-dd'T'HH:mm:ss)
page	query	integer	No	1	Page number (1-indexed)
page_size	query	integer	No	1000	Items per page

Example Request

cURL

curl -X GET "https://datafeed.ub-speeda.com/japan/ranking/v1/industries?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25" \
  -H "Authorization: Bearer {access_token}"

Python

import requests
response = requests.get(
    "https://datafeed.ub-speeda.com/japan/ranking/v1/industries",
    headers={"Authorization": "Bearer {access_token}"},
    params={"start_datetime": "2024-01-01T00:00:00", "end_datetime": "2024-01-31T23:00:00", "page": 1, "page_size": 25},
)
print(response.json())

Java

import java.net.URI;
import java.net.http.*;

HttpResponse<String> response = HttpClient.newHttpClient().send(
    HttpRequest.newBuilder()
        .uri(URI.create("https://datafeed.ub-speeda.com/japan/ranking/v1/industries?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25"))
        .header("Authorization", "Bearer {access_token}")
        .GET()
        .build(),
    HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());

Node.js

const response = await fetch(
  "https://datafeed.ub-speeda.com/japan/ranking/v1/industries?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25",
  { headers: { Authorization: "Bearer {access_token}" } }
);
console.log(await response.json());

Kotlin

import java.net.URI
import java.net.http.*

val response = HttpClient.newHttpClient().send(
    HttpRequest.newBuilder()
        .uri(URI.create("https://datafeed.ub-speeda.com/japan/ranking/v1/industries?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25"))
        .header("Authorization", "Bearer {access_token}")
        .GET()
        .build(),
    HttpResponse.BodyHandlers.ofString()
)
println(response.body())

Go

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

req, _ := http.NewRequest("GET", "https://datafeed.ub-speeda.com/japan/ranking/v1/industries?start_datetime=2024-01-01T00:00:00&end_datetime=2024-01-31T23:00:00&page=1&page_size=25", nil)
req.Header.Set("Authorization", "Bearer {access_token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

Example Response

{
  "data": [
    {
      "industryId": "IND001",
      "industryName": "Automobile Manufacturing",
      "industryDescription": "Companies engaged in the manufacturing of automobiles",
      "sectorName": "Consumer Discretionary",
      "subSectorName": "Automobiles & Components",
      "totalPageViews": 125000,
      "totalUniquePageViews": 45000
    },
    {
      "industryId": "IND002",
      "industryName": "Semiconductor Manufacturing",
      "industryDescription": "Companies engaged in the manufacturing of semiconductors",
      "sectorName": "Information Technology",
      "subSectorName": "Semiconductors & Equipment",
      "totalPageViews": 98000,
      "totalUniquePageViews": 38000
    }
  ],
  "page": 1,
  "pageSize": 25,
  "total": 150
}