{"id":17269547,"url":"https://github.com/rgab1508/jokesandpickupapi","last_synced_at":"2026-04-30T17:31:47.055Z","repository":{"id":115728974,"uuid":"285976310","full_name":"rgab1508/jokesandpickupapi","owner":"rgab1508","description":"API for Jokes and Pickup lines","archived":false,"fork":false,"pushed_at":"2020-09-09T14:58:06.000Z","size":50,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T11:47:04.235Z","etag":null,"topics":["api","flask","flask-application","jokes","pickup","praw","praw-reddit","reddit","reddit-api"],"latest_commit_sha":null,"homepage":"https://jokeandpickupapi.herokuapp.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rgab1508.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-08T04:59:19.000Z","updated_at":"2020-09-15T08:34:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"1f90317d-27e3-4a95-b506-c04eb9a382e8","html_url":"https://github.com/rgab1508/jokesandpickupapi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rgab1508/jokesandpickupapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgab1508%2Fjokesandpickupapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgab1508%2Fjokesandpickupapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgab1508%2Fjokesandpickupapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgab1508%2Fjokesandpickupapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rgab1508","download_url":"https://codeload.github.com/rgab1508/jokesandpickupapi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgab1508%2Fjokesandpickupapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32472396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"ssl_error","status_checked_at":"2026-04-30T13:12:06.837Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["api","flask","flask-application","jokes","pickup","praw","praw-reddit","reddit","reddit-api"],"created_at":"2024-10-15T08:16:44.033Z","updated_at":"2026-04-30T17:31:47.039Z","avatar_url":"https://github.com/rgab1508.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jokes \u0026 Pickup Line Api\n--------------------------\nThis API returns jokes and pickuplines form [r/Jokes](https://www.reddit.com/r/Jokes) and [r/pickuplines](https://www.reddit.com/r/pickuplines)\n\nlive-demo: https://jokeandpickupapi.herokuapp.com/\n\n### Parameters\n\n| Parameter         |        Description                 | Required | Default  |                 Constraints                 |\n--------------------|------------------------------------|----------|----------|---------------------------------------------|\n| ```time_filter``` | time the post was made             |     Yes  |```None```|```['all', 'year', 'month', 'week', 'day']```|\n| ```limit```       | Limit the number of post to return |     No   |```10```  | ```Interger```                              |\n\n### Endpoints\n``` base_url: https://jokeandpickupapi.herokuapp.com/```\n\n#### Jokes\n|     Endpoint                                   |     Description                     | Status |\n|------------------------------------------------|-------------------------------------|--------|\n|```/joke/random ```                             | Get a random joke                   | Active |\n|```/joke/new/\u003climit\u003e ```                        | Get jokes from New Posts            | Active |\n|```/joke/top/\u003ctime_filter\u003e/\u003climit\u003e ```          | Get jokes from Top posts            | Active |\n|```/joke/controversial/\u003ctime_filter\u003e/\u003climit\u003e ```| Get jokes from controversial posts  | Active |\n|```/joke/rising/\u003ctime_filter\u003e/\u003climit\u003e ```       | Get jokes form Rising posts         | Active |\n\n#### Pickup Lines\n|     Endpoint                                     |     Description                            | Status |\n|--------------------------------------------------|--------------------------------------------|--------|\n|```/pickup/random ```                             | Get a random Pickup Line                   | Active |\n|```/pickup/new/\u003climit\u003e ```                        | Get Pickup Lines from New Posts            | Active |\n|```/pickup/top/\u003ctime_filter\u003e/\u003climit\u003e ```          | Get Pickup Lines from Top posts            | Active |\n|```/pickup/controversial/\u003ctime_filter\u003e/\u003climit\u003e ```| Get Pickup Lines from controversial posts  | Active |\n|```/pickup/rising/\u003ctime_filter\u003e/\u003climit\u003e ```       | Get Pickup Lines form Rising posts         | Active |\n\n\n#### Example\n\n``` GET https://jokeandpickupapi.herokuapp.com/joke/random ```\n\n\n``` Response \n    {\n          \"id\": \"i5tz0f\",\n          \"url\": \"https://www.reddit.com/r/Jokes/comments/i5tz0f/how_dare_the_government_infringe_on_my_freedoms/\",\n          \"upvote_ratio\": 0.67,\n          \"over_18\": false,\n          \"name\": \"t3_i5tz0f\",\n          \"title\": \"How dare the Government infringe on my freedoms by forcing me to wear a bit of cloth covering a part of my\n          body...\",\n          \"body\": \"Nudists unite!\"\n    }\n```\n\n##### Run the server yourself\n###### setting reddit account \u0026\u0026 getting api keys\n+ make a [reddit developer account](https://www.reddit.com/)\n+ create a [reddit script app](https://www.reddit.com/prefs/apps/)\n+ store the api keys ,username \u0026 password in environment variable\n```\n    CLIENT_ID='client id from the app'\n    CLIENT_SECRET='client secret from the app'\n    USER_NAME='your reddit username'\n    USER_PASS='your reddit password'\n```\n\n###### clone repo and run\n+ clone the repository\n    ``` git clone https://github.com/rgab1508/jokeandpickupapi ```\n+ ```cd jokeandpickupapi```\n+ ```pip install -r requirements.txt```\n+ ```gunicorn wsgi:app```\n\n### dependencies\n+ ```flask```\n+ ```praw```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgab1508%2Fjokesandpickupapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frgab1508%2Fjokesandpickupapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgab1508%2Fjokesandpickupapi/lists"}