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-003.hey.cafe",
"system_api_timestamp": "20260708170557",
"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": {
"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": "3724",
"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": "2848",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"ihpd5zjco2smp4s": {
"id": "ihpd5zjco2smp4s",
"alias": "cannabis",
"name": "Cannabis Lounge",
"mode": "public",
"status": "active",
"type": "support",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Learn about cannabis: history, research, information, news & recipes. You are welcome to start a conversation. Ask questions. Share a infused recipe, a strain you like, or how old you were when you discovered weed. 🌱🔥🧈🍪🥳💨 Enjoy!",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302170846-dq47n9wbojl7ur5.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302170303-gwhvmowtkd2672q.jpeg",
"members": "204",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"7pyjh62vsklnitr": {
"id": "7pyjh62vsklnitr",
"alias": "idontwanttocookbutnooneelsewill",
"name": "What's for dinner??",
"mode": "public",
"status": "active",
"type": "food",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Will anyone join this cafe? I can't be the only one who never wants to cook, but apparently I'm the adult and we all need to eat. Maybe we can share fairly quick and easy ideas 🍽",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302120938-sv0gs5vnx729fbe.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302121258-q2mda6e46ka3mnu.jpg",
"members": "363",
"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": "143",
"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": "2745",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"ln4ng82tl555kzn": {
"id": "ln4ng82tl555kzn",
"alias": "ukraine",
"name": "We Support Ukraine!",
"mode": "public",
"status": "active",
"type": "community",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "This café is for anyone who supports Ukraine in their struggle to protect themselves from the aggressor russia.",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-04\/20250415205753-a00y5pgeesop5xf.png",
"header": "https:\/\/storage.heycafecdn.com\/2025-04\/20250415205609-tcwnhszhc4jnu4e.jpg",
"members": "421",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"7gudu2edrvvnmevo8dy7k9ca0": {
"id": "7gudu2edrvvnmevo8dy7k9ca0",
"alias": "books",
"name": "Book Lovers",
"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 cafe for book lovers to talk about books. ",
"avatar": "https:\/\/storage.heycafecdn.com\/2022-11\/20221119203912-ithhh7ih1a.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2022-11\/20221119203946-hbb8dzsq6o.jpg",
"members": "2390",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"iu9hvjd0iavvf93": {
"id": "iu9hvjd0iavvf93",
"alias": "worldnewsandmore",
"name": "World News and More",
"mode": "public",
"status": "active",
"type": "news",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Everyone is welcome to post things happening globally be it news, wars, global politics outside of the Canadian Politics Cafe, or anything else that one hasn't found a home for. Let's try to ensure that our posts are factual as there is plenty of misinformation out there - YouTube is famous for doing just that.",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-04\/20250420055001-kuzf73qfbwcejg2.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2025-04\/20250420055438-wb2bvrnfe84l6k5.jpg",
"members": "1238",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"yscb3enuinmsyr0": {
"id": "yscb3enuinmsyr0",
"alias": "thewitcheshollow",
"name": "The Witches Hollow",
"mode": "public",
"status": "active",
"type": "community",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Welcome To The Witches Hollow where you can make new witchy friends and this is a safe space for everyone and this is a place where everyone can talk about their practice and share knowledge.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302114121-5ur54h2k3ostm3u.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302114132-ou3t1hu7bimmgp0.jpeg",
"members": "58",
"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": "1649",
"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 @dee29 So pretty!",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260604194641-ly0zbn42wrsnttg.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260625124147-h74vz7m8jah81g3.jpg",
"members": "358",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"s6tvn0kwmfenzqg": {
"id": "s6tvn0kwmfenzqg",
"alias": "crazyaboutjazz",
"name": "Crazy About Jazz",
"mode": "public",
"status": "active",
"type": "false",
"public_react": "0",
"public_comment": "0",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "A café for lovers of Jazz Music",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260310103955-eullbfp1rw7r0uc.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260310104014-1ekk31i457agekq.jpg",
"members": "40",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"1rp00atk33v6p1s": {
"id": "1rp00atk33v6p1s",
"alias": "funnycanadamemesnopolitics",
"name": "Funny🇨🇦Memes\/Jokes",
"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": "Come share a laugh or a funny Canadian meme! ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301200426-sxb5qx56arfbuj9.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301195909-zpbdho169edkjke.jpeg",
"members": "378",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"pa2evps6y5ywrx8": {
"id": "pa2evps6y5ywrx8",
"alias": "albertaresisters",
"name": "Alberta Resisters",
"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": "I have set up this café to provide information on groups, websites and events for those who oppose the UCP government in Alberta as well as the separatist movement. If you need to rant. Feel free. If you support the UCP or the separatist movement I will likely exercise my right to limit your freedom of expression. ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302113907-e3ts2dz89ebolpt.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302114220-35fffsjldojnhh7.jpeg",
"members": "403",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"30ybuhs6jcnb6241c1iyej5lx": {
"id": "30ybuhs6jcnb6241c1iyej5lx",
"alias": "setup",
"name": "Desk Setups",
"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": "Share photos or links to great office or desk setups.",
"avatar": "https:\/\/storage.heycafecdn.com\/2021-09\/20210923171611-yarwdzfbfz.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2021-05\/20210516234055-mcvwqas008.jpg",
"members": "76",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"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
},
"eb0rg7705eg4jcz": {
"id": "eb0rg7705eg4jcz",
"alias": "radiopresenterscafe",
"name": "Radio Presenters Cafe",
"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": "This cafe is for Radio Presenters to swap stories, tunes and also Station Information",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260321154511-kjj8lbbx4o7svts.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260321152626-2yph8rxm07f64v2.jpg",
"members": "4",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"t8fpsicd5cpmmwg": {
"id": "t8fpsicd5cpmmwg",
"alias": "pv-tichnhathanh",
"name": "Plum Village \/ Followers of Thich Nhat Hanh",
"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": "This is not an official representative for Plum Village and\/or Thich Nhat Hanh. Just starting a cafe hoping to find other people who follow the teachings\/example of Thay (Thich Nhat Hanh). ",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-04\/20260419185003-4noe2t8szm5eers.gif",
"header": "https:\/\/storage.heycafecdn.com\/2026-04\/20260419184922-rrveyc6gznq9rk3.jpg",
"members": "9",
"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": "2329",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
}
},
"mutual": {
"q26x0omapr34wrl": 0,
"bdj5e0k8r9bdqhh": 0,
"ihpd5zjco2smp4s": 0,
"7pyjh62vsklnitr": 0,
"bg8ykmwy5lex7lg": 0,
"8bpxukp5gdk48bqyyqdqu3vnu": 0,
"ln4ng82tl555kzn": 0,
"7gudu2edrvvnmevo8dy7k9ca0": 0,
"iu9hvjd0iavvf93": 0,
"yscb3enuinmsyr0": 0,
"4r8fqyzs2ixe2cn": 0,
"r1cbqlfemf36vf3": 0,
"s6tvn0kwmfenzqg": 0,
"1rp00atk33v6p1s": 0,
"pa2evps6y5ywrx8": 0,
"30ybuhs6jcnb6241c1iyej5lx": 0,
"bgx4kcsvpy4b9ye": 0,
"eb0rg7705eg4jcz": 0,
"t8fpsicd5cpmmwg": 0,
"dq2eio22y8hqjj8": 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.