# googletrends/data architecture

> Architecture diagram of the GitHub repository googletrends/data, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googletrends/data
- Repository: https://github.com/googletrends/data
- Video tour (about a minute): https://gitdiagram.com/googletrends/data/video

## Overview

This repository is a public collection of datasets used for Google Trends graphics, interactives, and analysis, rather than a data-processing service. Its visible browser workflow loads a published spreadsheet as CSV, filters and paginates its records, and offers links to download dataset files. The archive spans many subjects and formats; representative files below stand for that collection. The source excerpt shows the browser logic, but not how `index.html` initializes it, so that connection is left out.

Main entry points: [`tableload.js`](https://github.com/googletrends/data/blob/master/tableload.js) (Table loader), [`index.html`](https://github.com/googletrends/data/blob/master/index.html) (Browser page), [`20221017_TopIssuesByDistrict.csv`](https://github.com/googletrends/data/blob/master/20221017_TopIssuesByDistrict.csv) (Election datasets), [`2018-06-06_WorldCupTeamsXCountry.csv`](https://github.com/googletrends/data/blob/master/2018-06-06_WorldCupTeamsXCountry.csv) (Sports datasets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Dataset browser"]
  node_page["Browser page<br/>[index.html]"]
  node_config["Browser parameters<br/>[params.json]"]
  node_loader["Table loader<br/>[tableload.js]"]
  node_results["Filtered table<br/>[index.html]"]
  node_styles["Table styles<br/>[table.css]"]
end

subgraph group_archive["Dataset archive"]
  node_elections["Election datasets"]
  node_sports["Sports datasets"]
  node_seasonal["Seasonal datasets"]
end

subgraph group_controls["Browser controls"]
  node_datepicker["Date picker<br/>[pikaday.js]"]
end

node_visitor(("Dataset explorer"))
node_trends[("Published spreadsheet")]
node_parser["Papa Parse"]
node_filehost["GitHub raw files"]

node_visitor -->|"opens"| node_page
node_page -->|"views"| node_results
node_loader -->|"requests CSV"| node_trends
node_loader -->|"parses with"| node_parser
node_loader -->|"creates"| node_datepicker
node_loader -->|"renders rows"| node_results
node_visitor -->|"filters and pages"| node_loader
node_loader -->|"links downloads"| node_filehost
node_filehost -->|"serves files"| node_elections
node_filehost -->|"serves files"| node_sports
node_filehost -->|"serves files"| node_seasonal

click node_page "https://github.com/googletrends/data/blob/master/index.html"
click node_config "https://github.com/googletrends/data/blob/master/params.json"
click node_loader "https://github.com/googletrends/data/blob/master/tableload.js"
click node_results "https://github.com/googletrends/data/blob/master/index.html"
click node_datepicker "https://github.com/googletrends/data/blob/master/Pikaday/pikaday.js"
click node_styles "https://github.com/googletrends/data/blob/master/stylesheets/table.css"
click node_elections "https://github.com/googletrends/data/blob/master/20221017_TopIssuesByDistrict.csv"
click node_sports "https://github.com/googletrends/data/blob/master/2018-06-06_WorldCupTeamsXCountry.csv"
click node_seasonal "https://github.com/googletrends/data/blob/master/20221018_HalloweenCostumes_Frightgeist.csv"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_page,node_config,node_loader,node_results,node_styles toneBlue
class node_elections,node_sports,node_seasonal,node_trends toneAmber
class node_datepicker toneMint
class node_visitor,node_parser,node_filehost toneIndigo
```

## Components

### Dataset browser

- [Browser page](https://github.com/googletrends/data/blob/master/index.html): `index.html`
- [Browser parameters](https://github.com/googletrends/data/blob/master/params.json): `params.json`
- [Table loader](https://github.com/googletrends/data/blob/master/tableload.js): `tableload.js`
- [Filtered table](https://github.com/googletrends/data/blob/master/index.html): `index.html`
- [Table styles](https://github.com/googletrends/data/blob/master/stylesheets/table.css): `stylesheets/table.css`

### Dataset archive

- [Election datasets](https://github.com/googletrends/data/blob/master/20221017_TopIssuesByDistrict.csv): `20221017_TopIssuesByDistrict.csv`
- [Sports datasets](https://github.com/googletrends/data/blob/master/2018-06-06_WorldCupTeamsXCountry.csv): `2018-06-06_WorldCupTeamsXCountry.csv`
- [Seasonal datasets](https://github.com/googletrends/data/blob/master/20221018_HalloweenCostumes_Frightgeist.csv): `20221018_HalloweenCostumes_Frightgeist.csv`

### Browser controls

- [Date picker](https://github.com/googletrends/data/blob/master/Pikaday/pikaday.js): `Pikaday/pikaday.js`

### Other components

- **Dataset explorer**
- **Published spreadsheet**
- **Papa Parse**
- **GitHub raw files**

## Connections

- Dataset explorer → Browser page: opens
- Browser page → Filtered table: views
- Table loader → Published spreadsheet: requests CSV
- Table loader → Papa Parse: parses with
- Table loader → Date picker: creates
- Table loader → Filtered table: renders rows
- Dataset explorer → Table loader: filters and pages
- Table loader → GitHub raw files: links downloads
- GitHub raw files → Election datasets: serves files
- GitHub raw files → Sports datasets: serves files
- GitHub raw files → Seasonal datasets: serves files