{"id":17422315,"url":"https://github.com/ornato-t/flairchange_bot-api","last_synced_at":"2025-03-27T23:44:08.651Z","repository":{"id":37772344,"uuid":"503033479","full_name":"ornato-t/flairchange_bot-api","owner":"ornato-t","description":"A data aggregation API for r/PoliticalCompassMemes","archived":false,"fork":false,"pushed_at":"2022-07-03T15:44:41.000Z","size":294,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-02T01:46:33.541Z","etag":null,"topics":["reddit","reddit-api","reddit-bot"],"latest_commit_sha":null,"homepage":"https://flairchangebot-api.herokuapp.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ornato-t.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-13T16:29:04.000Z","updated_at":"2023-09-04T09:50:22.000Z","dependencies_parsed_at":"2022-08-18T17:51:45.398Z","dependency_job_id":null,"html_url":"https://github.com/ornato-t/flairchange_bot-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ornato-t%2Fflairchange_bot-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ornato-t%2Fflairchange_bot-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ornato-t%2Fflairchange_bot-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ornato-t%2Fflairchange_bot-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ornato-t","download_url":"https://codeload.github.com/ornato-t/flairchange_bot-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245944062,"owners_count":20697948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["reddit","reddit-api","reddit-bot"],"created_at":"2024-10-17T03:23:50.965Z","updated_at":"2025-03-27T23:44:08.627Z","avatar_url":"https://github.com/ornato-t.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flairchange_bot-api\nAn API aggregating data coming from r/PoliticalCompassMemes, gathered and processed by u/[flairchange_bot](https://github.com/ornato-t/flairchange_bot).\n\n# Endpoints\n\nEach endpoint can be accessed by opening the url linked on the sidebar. The API supports the following endpoints:\n\n## `GET /u/\u003cname\u003e`\nWith \u0026lt;name\u0026gt; being a Reddit username.  \n\nReturns a JSON object containing a user's flair history, including the date of each flair change.  \nFlair change data is stored in the `flairs` array. Each object represents a change: user `name` changed its flair to `flairs[i].flair` on `flairs[i].dateAdded`.\n\nReturns a 400 error for a badly formulated request or 404 for a missing entry in the database.\n### Example\n`{`  \n\u0026ensp;`\"name\": \"flairchange_bot\",`  \n\u0026ensp;`\"flairs\": [{`  \n\u0026emsp;`\"flair\": \"AuthCenter\",`  \n\u0026emsp;`\"dateAdded\": 2022-04-26T22:29:54.489Z\"`  \n\u0026ensp;`}, {`  \n\u0026emsp;`\"flair\": \"GreyCentrist\",`  \n\u0026emsp;`\"dateAdded\": 2022-06-01T00:00:00.000Z\"`  \n\u0026ensp;`}]`  \n`}`  \n\n*Note: this is just an example, flairchange_bot has clearly never changed his flair, as that would make him cringe.*\n\n## `GET /leaderboard`\nReturns an array containing the top 50 flair changers of r/PoliticalCompassMemes. Can be followed by a parameter to limit/expand the returned results.\n### Example\n`[{`  \n\u0026emsp;`\"name\": \"flair-checking-bot\",`  \n\u0026emsp;`\"flairs\": [],`  \n\u0026emsp;`\"size\": 300,`  \n\u0026emsp;`\"position\": 1`  \n\u0026ensp;`}, ...]`  \n\n## `GET /leaderboard/\u003cN\u003e`\nWith \u0026lt;N\u0026gt; being a natural number.  \n\nReturns an array containing the top N flair changers of r/PoliticalCompassMemes. Doesn't accept a negative parameter or a parameter greater than 500.\n\nThe returned values are the same as [/leaderboard](#get-leaderboard).\n\n\n## `GET /stats`  \nReturns a JSON object containing the all the flair statistics of r/PoliticalCompassMemes. It is composed of key-value pairs, composed by a flair and the number of users having such flair. This dataset includes the recently added special \"chad\" flairs as well as older flairs that are no longer available.\n### Example\n`{`  \n\u0026emsp;`\"AuthCenter\": \"32\",`  \n\u0026emsp;`\"Chad AuthCenter\": \"1\",`  \n\u0026emsp;`\"Centrist\": \"20\",`  \n\u0026emsp;`\"GreyCentrist\": \"40\"`  \n`}`\n\n## `GET /stats/filter`  \nReturns the same data as `/stats` but filters out the *special* flairs (such as \"chad\", \"transhumanist\", \"grand inquisitor\"). Users with filtered flairs are counted as members of their original, non *special* flair. \n### Example\n`{`  \n\u0026emsp;`\"AuthCenter\": \"33\",`  \n\u0026emsp;`\"Centrist\": \"20\",`  \n\u0026emsp;`\"GreyCentrist\": \"40\"`  \n`}`\n\n## `GET /stats/noAlts`  \nReturns the same data as `/stats` but filters out the *alternative* flairs (such as \"PurpleLibright\" or \"GreyCentrist\"). Users with filtered flairs are counted as members of their original, non *alternative* flair. \n### Example\n`{`  \n\u0026emsp;`\"AuthCenter\": \"32\",`  \n\u0026emsp;`\"Chad AuthCenter\": \"1\",`  \n\u0026emsp;`\"Centrist\": \"60\"`  \n`}`\n\n\n## `GET /stats/filter/noAlts`  \nCombines the two previously introduced endpoints. Returns the same data as `/stats` but filters out both the *special* and the *alternative* flairs. Users with filtered flairs are counted as members of their original, non *special*, non *alternative* flair. \n### Example\n`{`  \n\u0026emsp;`\"AuthCenter\": \"33\",`  \n\u0026emsp;`\"Centrist\": \"60\"`  \n`}`\n\n\n# Access\nAccess to the API is free and open to all. If you are interested in additional endpoints write a Reddit message to u/Nerd02.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fornato-t%2Fflairchange_bot-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fornato-t%2Fflairchange_bot-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fornato-t%2Fflairchange_bot-api/lists"}