Categorygithub.com/guidoman/github-random-trend
modulepackage
0.0.0-20200922153230-42a85dcbefb5
Repository: https://github.com/guidoman/github-random-trend.git
Documentation: pkg.go.dev

# README

Github random trend API

This is a Rest API that will return (or redirect to) a random URL of a trending Github repository.

Usage

This project uses the Github Unofficial Trending API, by Hu Chen. All query string parameters of Hu Chen's API are supported:

  • language
  • since
  • spoken_language_code

This API accepts an additional parameter named redirect:

  • if true, the request will be redirected to the resulting random Github repository
  • otherwise, the random repository URL is returned as plain text

The API is currently deployed on Google Cloud App Engine.

Examples

Get the URL of a random repository: https://github-random-trend-dot-guidoc-tech.oa.r.appspot.com/repo?redirect=true

Redirect to random Python repository trending this week: https://github-random-trend-dot-guidoc-tech.oa.r.appspot.com/repo?language=python&since=week&redirect=true

Get the URL of a random trending Italian-speaking repository: https://github-random-trend-dot-guidoc-tech.oa.r.appspot.com/repo?spoken_language_code=it

Usage suggestions

You could, for example, set the home page of your browser to this API URL (with redirect=true). Everytime you open a new tab or page you will discover and learn something new:

  • frameworks, libraries, applications
  • ideas
  • company or developer
  • ...

Notes

This API is implemented with the Go programming language.

# Structs

Trend API response JSON.