Hey.Café Endpoint Docs
Get Explore Cafes
get_explore_ cafes
Get a list of recently active and intresting cafés.
https://endpoint.hey.cafe/get_explore_cafesVariables
A list of variables needed to make the call work, they can be provided via the URL or POST.
countHow many items to return (default 20).
suggestIf provide TRUE we will show cafés not where the current user is not also a member.
Example Response
https://endpoint.hey.cafe/get_explore_cafes{
"system_api_endpoint": "endpoint-008.hey.cafe",
"system_api_timestamp": "20260718003135",
"system_api_request_ip": "0.0.0.0",
"system_api_request_status": "valid",
"system_api_request_country": "FI",
"system_api_error": false,
"system_api_error_reason": "",
"response_data": {
"found_items": true,
"cafes": {
"bgx4kcsvpy4b9ye": {
"id": "bgx4kcsvpy4b9ye",
"alias": "musicshare",
"name": "Music Sharing",
"mode": "public",
"status": "active",
"type": "entertainment",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "A café to share and talk about music with other people!",
"avatar": "https:\/\/storage.heycafecdn.com\/2023-06\/20230611201214-i6v0bagq85k4j57.png",
"header": "https:\/\/storage.heycafecdn.com\/2023-06\/20230611201744-5psog0axsety26i.jpg",
"members": "530",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"bdj5e0k8r9bdqhh": {
"id": "bdj5e0k8r9bdqhh",
"alias": "guardtheleaf",
"name": "Guard The Leaf Community",
"mode": "public",
"status": "active",
"type": "canadian",
"public_react": "0",
"public_comment": "0",
"public_view": "0",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Gathering space for the Guard The Leaf Youtube Channel. Possibly also Co-Host photos too",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304190557-wg2l5wfs37pazni.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304190540-ifmtcz9gix4kyr5.png",
"members": "2863",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"lkwvkw52iubxh1k": {
"id": "lkwvkw52iubxh1k",
"alias": "canadianmusic",
"name": "Canadian Music",
"mode": "public",
"status": "active",
"type": "canadian",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "All things Canadian Music, past or present!",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304114850-0o0h3u5zk3q8usq.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304114637-ys23qdgyy09su21.jpg",
"members": "494",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"kh28uyq9qc5la33uoh3rxqc95": {
"id": "kh28uyq9qc5la33uoh3rxqc95",
"alias": "gaming",
"name": "Gaming",
"mode": "public",
"status": "active",
"type": "gaming",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Chat about or share news on anything gaming related.",
"avatar": "https:\/\/storage.heycafecdn.com\/2021-10\/20211007213104-rdr9xhs318.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2021-10\/20211007213114-orb9kr5qp7.jpg",
"members": "404",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"bg8ykmwy5lex7lg": {
"id": "bg8ykmwy5lex7lg",
"alias": "cafe_au_lait",
"name": "Café au Lait",
"mode": "public",
"status": "active",
"type": "community",
"public_react": "1",
"public_comment": "0",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "This café is for chit chat. No drama! Rude behaviour will not be tolerated. Chat about the weather, kids, new toys, what happened in your day. Share new things, stories etc... ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260622183650-v0ysmshv4r6qfdj.webp",
"header": "https:\/\/storage.heycafecdn.com\/2026-05\/20260526044209-z81bfsqzqm4w4po.jpg",
"members": "151",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"0e7t65c171d8mbhc0gxxz75v9": {
"id": "0e7t65c171d8mbhc0gxxz75v9",
"alias": "politics",
"name": "Politics",
"mode": "public",
"status": "active",
"type": "politics",
"public_react": "1",
"public_comment": "1",
"public_view": "0",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "A global community for political discussion. Be considerate, and take a breath. __ You may see differences in opinions, that happens in conversations around politics, as such posts made here will ONLY show if you join the café. __",
"avatar": "https:\/\/storage.heycafecdn.com\/2022-01\/20220124193340-jyexk68c1s.png",
"header": "https:\/\/storage.heycafecdn.com\/2022-01\/20220124193422-mdsnh59wtf.jpg",
"members": "655",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"dq2eio22y8hqjj8": {
"id": "dq2eio22y8hqjj8",
"alias": "dogs",
"name": "Dogs of Hey.Cafe",
"mode": "public",
"status": "active",
"type": "animals",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "A safe space for dogs of all kinds! #dogs #dogsofheycafe",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-02\/20250227101050-cwz4zs5fz1k5y6l.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2025-02\/20250227101309-vrpgqlm46mqmqkt.jpeg",
"members": "2334",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"8bpxukp5gdk48bqyyqdqu3vnu": {
"id": "8bpxukp5gdk48bqyyqdqu3vnu",
"alias": "cats",
"name": "Cats Of Hey.Café",
"mode": "public",
"status": "active",
"type": "animals",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Hey! You can share photos of your cat here.",
"avatar": "https:\/\/storage.heycafecdn.com\/2021-05\/20210516234408-fph2m7o33o.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2021-05\/20210516234416-8sgz85wi2u.jpg",
"members": "2757",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"q26x0omapr34wrl": {
"id": "q26x0omapr34wrl",
"alias": "canadianpolitics",
"name": "Canadian Politics",
"mode": "public",
"status": "active",
"type": "politics",
"public_react": "1",
"public_comment": "1",
"public_view": "0",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "A place to share everything related to Canadian Politics at the Federal, Provincial\/Territorial and Municipal levels. __ You may see differences in opinions, that happens in conversations around politics, as such posts made here will ONLY show if you join the café. __",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-03\/20250323092824-gpmtcbrq7xjzmol.png",
"header": "https:\/\/storage.heycafecdn.com\/2025-03\/20250323092837-cu0zpv1z7hv1fip.png",
"members": "3735",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"4r8fqyzs2ixe2cn": {
"id": "4r8fqyzs2ixe2cn",
"alias": "cdnsrs",
"name": "Canadian Seniors 🇨🇦",
"mode": "public",
"status": "active",
"type": "community",
"public_react": "0",
"public_comment": "0",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Created as a meeting place for Canadian Seniors - 55ish + ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-04\/20260403132421-x271gvhmzojv2kq.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260309174834-1thj2ycp51su299.jpg",
"members": "1665",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"gsii32rl34zr9t4": {
"id": "gsii32rl34zr9t4",
"alias": "tod",
"name": "Tod Maffin's Community",
"mode": "public",
"status": "active",
"type": "canadian",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Café setup by @anthony for @todmaffin for general conversations.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301184538-1ytlhxmikqdsqsz.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301201721-oa9jlgtwhi4okb8.jpg",
"members": "11026",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"ixxiqehrpodobl7": {
"id": "ixxiqehrpodobl7",
"alias": "boardgaming",
"name": "Board Gaming",
"mode": "public",
"status": "active",
"type": "gaming",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "This cafe is about board games. Talk about your favourite games, new and upcoming games, as well as any and all news related to the subject! Rules: Be civil. Be kind. ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260323183231-6za9dfi8r1w6hik.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302143524-7q24vwaxcq3zpnu.jpeg",
"members": "119",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"1c40xjsw08kakwhqyhmynqtm1": {
"id": "1c40xjsw08kakwhqyhmynqtm1",
"alias": "photography",
"name": "Photography",
"mode": "public",
"status": "active",
"type": "entertainment",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Photography is the art, application, and practice of creating durable images by recording light, either electronically by means of an image sensor, or chemically by means of a light-sensitive material such as photographic film.",
"avatar": "https:\/\/storage.heycafecdn.com\/2021-09\/20210923171009-yxhg2la4c6.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-05\/20260502074401-e8xzu5wl1y2hth5.jpg",
"members": "1578",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"wvmaif1fj92frtx": {
"id": "wvmaif1fj92frtx",
"alias": "whattowatchnext",
"name": "What to Watch Next",
"mode": "public",
"status": "active",
"type": "entertainment",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "🎬 Welcome to What to Watch Next Café! 🍿 This is a friendly space for anyone who loves discovering great shows and films. Share what you’re watching, recommend hidden gems, ask for suggestions, and chat about the series or movies that stuck with you long after the credits rolled. Grab some popcorn and enjoy the show! 🎥 🍿 ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260312035918-skbyv8bl1xgncyu.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260312040222-407dukrqyq1f08y.png",
"members": "130",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"r1cbqlfemf36vf3": {
"id": "r1cbqlfemf36vf3",
"alias": "bloomscrolling",
"name": "Bloomscrolling",
"mode": "public",
"status": "active",
"type": "hobbies",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Share all of your favourite blooms! Scrolling through beautiful flowers through the seasons always makes me happy! An Anthophile = a person who loves flowers. Our header photo is from @cdnviolets So pretty!",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260604194641-ly0zbn42wrsnttg.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-07\/20260714164039-0utux54q6sv31je.jpg",
"members": "364",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"nnp98j05fonhpa0": {
"id": "nnp98j05fonhpa0",
"alias": "oursecretgardens",
"name": "Our Secret Gardens",
"mode": "public",
"status": "active",
"type": "false",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "I have gardened since I was a child. From vegetable gardens, flower gardens, and dandelion gardens. I always dreamed of "Secret Gardens" only I and maybe a fairy or 2 know about. Join me in creating a Secret Garden, share a photo of a leaf, flowers, plants, trees. Maybe a Fairy? Together we can create our Secret Garden. But don't tell a",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260629132152-c7cqs1ex4epfmnv.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260629132204-vpcwjwfwmls3oh5.jpg",
"members": "4",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"1cq4y2coxdebb59": {
"id": "1cq4y2coxdebb59",
"alias": "creatorsofbeauty",
"name": "Arts and Crafts",
"mode": "public",
"status": "active",
"type": "hobbies",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "If your hands create beauty (or even just practicality), this is the place to show it off! ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260324191725-2cunwimy2v9vysy.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260324193101-70nzmbgxqhun8rz.jpg",
"members": "137",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"x20x8n91wycokhp": {
"id": "x20x8n91wycokhp",
"alias": "ehcanadaehusa",
"name": "EH Canada, EH USA",
"mode": "public",
"status": "active",
"type": "false",
"public_react": "0",
"public_comment": "0",
"public_view": "0",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Welcome to EH Canada, EH USA. I’m the TRUTH BITCH who built this place because I got tired of watching bad info spread faster than real news. Around here I fact-check first, roast nonsense second, and take politicians’ talking points apart just. If Canada 1st USA 2nd, & democracy always” sounds like your kind of chaos, pull up a c",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260616175612-v2walmr5phb738c.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260316044739-wuscez3u0195al0.jpeg",
"members": "111",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"qbzc9e0zkugtdqa": {
"id": "qbzc9e0zkugtdqa",
"alias": "amigurumicrochet",
"name": "Amigurumi Crocheters",
"mode": "public",
"status": "active",
"type": "hobbies",
"public_react": "0",
"public_comment": "0",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Let's see what is HOTH! Be kind!",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-03\/20250303192040-sckksgu18scs9ih.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2025-03\/20250303193223-8lti1ir9bhzascf.jpg",
"members": "54",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"macvt7g4ixlz9kz": {
"id": "macvt7g4ixlz9kz",
"alias": "artistsartlovers",
"name": "Art",
"mode": "public",
"status": "active",
"type": "hobbies",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "A place for anybody to post their artwork",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-02\/20250226180656-mpunh3lwj1gh411.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2025-02\/20250225065101-ddy20pnu8h2rtzu.jpeg",
"members": "1321",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
}
},
"mutual": {
"bgx4kcsvpy4b9ye": 0,
"bdj5e0k8r9bdqhh": 0,
"lkwvkw52iubxh1k": 0,
"kh28uyq9qc5la33uoh3rxqc95": 0,
"bg8ykmwy5lex7lg": 0,
"0e7t65c171d8mbhc0gxxz75v9": 0,
"dq2eio22y8hqjj8": 0,
"8bpxukp5gdk48bqyyqdqu3vnu": 0,
"q26x0omapr34wrl": 0,
"4r8fqyzs2ixe2cn": 0,
"gsii32rl34zr9t4": 0,
"ixxiqehrpodobl7": 0,
"1c40xjsw08kakwhqyhmynqtm1": 0,
"wvmaif1fj92frtx": 0,
"r1cbqlfemf36vf3": 0,
"nnp98j05fonhpa0": 0,
"1cq4y2coxdebb59": 0,
"x20x8n91wycokhp": 0,
"qbzc9e0zkugtdqa": 0,
"macvt7g4ixlz9kz": 0
}
}
}Response Modifications
We have a few URL options you can provide to modify the API response. If you have any suggestions let us know.
&convert_numeric=VARIABLE
This option will turn an array into a numeric response instead of KEYs when provided with the variable to modify. It will only work on main level variables at this time for example in the call endpoint.hey.cafe/api/account_conversations?query=anthony&convert_numeric=conversations.
&error_boolean=true
Return all responses in system_api_error as a boolean true or false only. If there is an error message when this is active it will be provided in system_api_error_message.
&error_no_http=true
Do not modify the HTTP response code when any error response happens, keep the HTTP response code as 200.
Flags
Some requests have rules that must be followed, they are done on the API end and will be automatically validated and if failed you will get an error message.
Needs Session
On fail will return needs_session and if this falg is set the request will only respond if made by a valid user session or API session.
Needs Agecheck
On fail you will get the response of needs_agecheck and this happens if request is made from an IP in a country or region that has an age verification law. To use this the IP must not be based in an age check region or the user must do the age verification in settings first.