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-010.hey.cafe",
"system_api_timestamp": "20260801060319",
"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": {
"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": "181",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"obv4qh8ud2gmajy": {
"id": "obv4qh8ud2gmajy",
"alias": "pareidolia",
"name": "Hidden Faces",
"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": "A place for those who don't just see a rock, but also a million stories carved in it. A cloud is a celestial Zoo, and a photograph of a rose reveals Einstein quarreling with Santa in the background.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-07\/20260710104345-jab9ruxwys473iw.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-07\/20260710120352-63hh0v72c7daugz.jpg",
"members": "35",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"aw9043ttzshs8gy2f0fdolxuj": {
"id": "aw9043ttzshs8gy2f0fdolxuj",
"alias": "memes",
"name": "Memes",
"mode": "public",
"status": "active",
"type": "humour",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Drink a sip of cafe and enjoy some memes… #TheOriginal",
"avatar": "https:\/\/storage.heycafecdn.com\/2021-10\/20211013124700-q83fzsoh1r.png",
"header": "https:\/\/storage.heycafecdn.com\/2021-10\/20211013125117-86zl2qg6zx.png",
"members": "209",
"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": "1747",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"dfqagiw78gr9paq": {
"id": "dfqagiw78gr9paq",
"alias": "kas",
"name": "🇨🇦 Astronomy & Space Enthusiasts",
"mode": "public",
"status": "active",
"type": "canadian",
"public_react": "1",
"public_comment": "0",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Welcome to everyone everywhere who has an interest in astronomy and space sciences! 🇨🇦 Based out of Kamloops, BC, Canada 🇨🇦",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-04\/20260406115431-kl2lnhu4x41x7tx.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-04\/20260410130402-gwcejh2pz8klgrb.jpg",
"members": "45",
"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": "3821",
"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": "545",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"cvw9kcnpxk2ht6d": {
"id": "cvw9kcnpxk2ht6d",
"alias": "transportation",
"name": "Transportation Photography",
"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": "This is a group interested in classic autos, but we wholeheartedly welcome images of trains, motorbikes, airplanes etc, as long as they are classics, whether they are rusty or restored.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260627164709-6s0gwrd9qgohwdv.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260627164702-iigf68mh6rtfald.jpg",
"members": "37",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"zk8adzyyq15xvts": {
"id": "zk8adzyyq15xvts",
"alias": "prysmquincunx",
"name": "Prysmcat's "Quincunx"",
"mode": "public",
"status": "active",
"type": "false",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "0",
"member_react": "1",
"member_comment": "1",
"member_feed": "0",
"bio": "Daily chapter posts of Prysmcat's unconventional isekai serial "Quincunx," about a gender-fluid paramedic waking up in a fantasy world very different from ours and finding friends—and enemies. This one is long, expect it to run into early October.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-05\/20260531190018-w2u5vcf894il52r.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260601080755-vcpgze6ycu2gavs.png",
"members": "5",
"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": "2796",
"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": "1606",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"uikgqn65zvuq7b3": {
"id": "uikgqn65zvuq7b3",
"alias": "canada",
"name": "Purchase Canadian \/ Acheter canadien",
"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": "Let's promote Canadian products, services, people and businesses. Canada First! Promouvons les produits, services, personnes et entreprises canadiennes. Le Canada d'abord !",
"avatar": "https:\/\/storage.heycafecdn.com\/2025-03\/20250302134732-tea63jm0le1j0qn.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2025-03\/20250302134638-flaiyr9kguyhm3e.jpg",
"members": "5957",
"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": "1298",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"y2yh6s792n4o9q7": {
"id": "y2yh6s792n4o9q7",
"alias": "oldgaymers",
"name": "Old Gaymers",
"mode": "private",
"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": "Place for 40+ LGBTQ2S+ Gamers to connect to game and chat. ",
"avatar": "https:\/\/storage.heycafecdn.com\/defaults\/avatar_cafe.png",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_cafe.jpg",
"members": "1",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"tgyxqv2l9mc6wk0": {
"id": "tgyxqv2l9mc6wk0",
"alias": "onlinebusinesscanada",
"name": "Online Business Canada",
"mode": "private",
"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": "This group is for learning, sharing and the mutual support of CANADIANS 🍁 who are interested in any legitimate type of online business, ecommerce, dropshipping, or digital marketing. You must be in Canada to join this group. Let's build...ONLINE! 🚫 NO SPAM ZONE!",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260328095703-lfpmikzhwr9aovi.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260328083540-0f3y3ou3rwf02ut.jpg",
"members": "58",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"8s67v6tqylij658": {
"id": "8s67v6tqylij658",
"alias": "wincity",
"name": "Windsor, Ontario",
"mode": "public",
"status": "active",
"type": "community",
"public_react": "0",
"public_comment": "0",
"public_view": "0",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "Windsor Ontario Incorporated as a city in 1892. Located at the southern tip of Ontario. Located directly across from the US border city Detroit, Michigan.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260307084630-z78i7zu4e9qmlg3.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_cafe.jpg",
"members": "25",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"nc4gx16mlaypb6gnmm5czxz3j": {
"id": "nc4gx16mlaypb6gnmm5czxz3j",
"alias": "btsarmy",
"name": "BTS",
"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": "A safe space for bts and armys💜",
"avatar": "https:\/\/storage.heycafecdn.com\/2022-12\/20221205094407-cionhzhy7u.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2022-12\/20221205094423-zkzoa928b4.jpg",
"members": "13",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"xme1gp62svocm2g": {
"id": "xme1gp62svocm2g",
"alias": "wanda",
"name": "I Need More Funny",
"mode": "public",
"status": "active",
"type": "humour",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"bio": "I’m not that funny. But I love funny. And I’m funnier when I’m with my sisters. Are you funny? Do you tell funny stories or draw funny pictures or take funny photos. We all need a laugh. Please join and give me a laugh so I don’t make my family miserable.",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260303070707-nyp33hkmbyvz8ay.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260303070620-rsduhz7fciferqw.jpeg",
"members": "510",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
},
"h15ymorj102nye0": {
"id": "h15ymorj102nye0",
"alias": "archaeology",
"name": "Archaeology",
"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'm an Egyptian archaeologist. I started this cafe to open discussion on archaeology. - Debborah Donnelly",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304113045-cfp63gs8860aeii.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304113058-sgdfqablfa1cxdp.jpg",
"members": "63",
"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 through history, research, information, news, & recipes. You’re welcome to start a conversation—ask questions, share an infused recipe, tell us about a favourite strain, or share how old you were when you first discovered cannabis. 🌱🔥🧈🍪🥳💨 Enjoy!",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302170846-dq47n9wbojl7ur5.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302170303-gwhvmowtkd2672q.jpeg",
"members": "220",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false
}
},
"mutual": {
"bg8ykmwy5lex7lg": 0,
"obv4qh8ud2gmajy": 0,
"aw9043ttzshs8gy2f0fdolxuj": 0,
"4r8fqyzs2ixe2cn": 0,
"dfqagiw78gr9paq": 0,
"q26x0omapr34wrl": 0,
"bgx4kcsvpy4b9ye": 0,
"cvw9kcnpxk2ht6d": 0,
"zk8adzyyq15xvts": 0,
"8bpxukp5gdk48bqyyqdqu3vnu": 0,
"1c40xjsw08kakwhqyhmynqtm1": 0,
"uikgqn65zvuq7b3": 0,
"iu9hvjd0iavvf93": 0,
"y2yh6s792n4o9q7": 0,
"tgyxqv2l9mc6wk0": 0,
"8s67v6tqylij658": 0,
"nc4gx16mlaypb6gnmm5czxz3j": 0,
"xme1gp62svocm2g": 0,
"h15ymorj102nye0": 0,
"ihpd5zjco2smp4s": 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.