Hey.Café Endpoint Docs
Get Explore Accounts
get_explore_ accounts
Get a list of recently active and intresting accounts.
https://endpoint.hey.cafe/get_explore_accountsVariables
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 accounts not followed by the logged in user based on mutual followers.
newIf provide TRUE we will show only accounts created in the last week.
proIf provide TRUE we will show only accounts that are PRO.
typeThe type of account to return, from person, business, robot, or creator.
Example Response
https://endpoint.hey.cafe/get_explore_accounts{
"system_api_endpoint": "endpoint-001.hey.cafe",
"system_api_timestamp": "20260811064845",
"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,
"accounts": {
"fdgmlqvr0mbr75eipg0xlv72n": {
"id": "fdgmlqvr0mbr75eipg0xlv72n",
"alias": "lisa",
"name": "Lisa Marie",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260320164146-5eeuz4rkuvze31g.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260303110414-yvpprtaswngzbcv.jpg",
"bio": "Hello, I'm one of the staff of Hey.Cafe. Let me know how I can help!",
"timeout": false,
"status": "active",
"seen": "20260811064845",
"active": "20260811064845",
"created": "20210925104603",
"verified": "1",
"pro": "1",
"type": "person",
"admin": "1",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"iqq24asa83tho7u": {
"id": "iqq24asa83tho7u",
"alias": "flipme",
"name": "Phil",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260305093454-sbiwt2fqh0nftvx.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260323071509-pvi7skyhd1h3abc.jpeg",
"bio": "Born in the Netherlands and proud Canadian",
"timeout": false,
"status": "active",
"seen": "20260811064845",
"active": "20260811064844",
"created": "20260303131316",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"4y1av7shbs81u43": {
"id": "4y1av7shbs81u43",
"alias": "nomadic_bucca",
"name": "Colin",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-05\/20260516105315-5a5kta36f15dr7f.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260331045408-sux1tx8usnkc3mu.jpg",
"bio": "Born Uranium City '67. Raised Port Hope, Vancouver & Saskatoon. Cut teeth on student stints: Manitouwadge, Fraser Lake, Campbell River, Yellowknife, Montréal. Career mostly Saskatchewan, with turns in Europe incl Cornwall (my ancestral roots) & Azerbaijan. Back to Canada after years in UK. A bit of a tramp miner (nowhere near as much as many).",
"timeout": false,
"status": "active",
"seen": "20260811064845",
"active": "20260811064839",
"created": "20260323045704",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"5s5ia4hn8d5042jbgpxpxxyzo": {
"id": "5s5ia4hn8d5042jbgpxpxxyzo",
"alias": "macrumors",
"name": "MacRumors (Not Official)",
"avatar": "https:\/\/storage.heycafecdn.com\/2022-01\/20220118192535-tivzfk05u6.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2022-01\/20220118192543-pm30995f1l.png",
"bio": "Direct feed of the public RSS feed. This is NOT an official account. Apple, iPhone, iPad and Mac rumors, news, tips and videos. (This is a non official account)",
"timeout": false,
"status": "active",
"seen": "20260308130248",
"active": "20260811064837",
"created": "20220118192141",
"verified": "0",
"pro": "0",
"type": "news",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"ur3gs9452rgni0h": {
"id": "ur3gs9452rgni0h",
"alias": "aledaj",
"name": "Aleda Johnson",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301195734-8xx73cm102l7b1n.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260307215804-ualkf3rmovj66po.jpg",
"bio": "AuDHD, nature lover, I appreciate old tools & methods, & believe in the need for a strong community (which will by definition of course be diverse). When possible, be kind. It is always possible.",
"timeout": false,
"status": "active",
"seen": "20260811064845",
"active": "20260811064833",
"created": "20260301180732",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"gvn7cdb8v4lwz7h": {
"id": "gvn7cdb8v4lwz7h",
"alias": "bobbyb",
"name": "R.J. Beaudoin 🍁",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304143235-tkwo6b3eas6eu79.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_account.jpg",
"bio": "Canuck, Quebecois, World Travelled, having worked and lived overseas for 25 years, now enjoying retirement in BC.. Still curious with broad and diverse cultural interests. Favorite Poem: Desiderata by Max Ehrmann ",
"timeout": false,
"status": "active",
"seen": "20260811064803",
"active": "20260811064804",
"created": "20260304142957",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"vex2ki0xuv4qn4u": {
"id": "vex2ki0xuv4qn4u",
"alias": "paulaubin",
"name": "Paul Aubin 🇨🇦🏳️🌈",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-07\/20260705182134-i7ke1h5l7tyexy9.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260607163916-wj4jssj06h6y6ds.jpg",
"bio": "Stage actor\/theatre artist, music teacher, and community volunteer in Cornwall, Ontario. @TodMaffin sent me!",
"timeout": false,
"status": "active",
"seen": "20260811064804",
"active": "20260811064754",
"created": "20260330103950",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"psmzm3e4e96m0aa": {
"id": "psmzm3e4e96m0aa",
"alias": "rvgrebtelus_net",
"name": "Ronnyg57",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260317064955-7nxuho9di6rtseo.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_account.jpg",
"bio": "Retired senior who doesn’t use social media much ",
"timeout": false,
"status": "active",
"seen": "20260811064753",
"active": "20260811064754",
"created": "20260317061917",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"7ff9qn8m6ivh7kq": {
"id": "7ff9qn8m6ivh7kq",
"alias": "mikeamcgraw",
"name": "Mike McGraw",
"avatar": "https:\/\/storage.heycafecdn.com\/defaults\/avatar_account.png",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_account.jpg",
"bio": "Hey I have no bio, I must be new!",
"timeout": false,
"status": "active",
"seen": "20260811064805",
"active": "20260811064746",
"created": "20260727155547",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"55wij4f2o3y7ag5": {
"id": "55wij4f2o3y7ag5",
"alias": "ariellearbour",
"name": "arielle lux arbour",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-06\/20260613122315-6ocqkndcpt6og7g.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260613122416-uxt5x4wzzk7srij.jpg",
"bio": "nanaimo islander french\/english disable but not dead yet ♿ aspie plant lover 🌱 Somatic Symptom Disorder 🖖🏼",
"timeout": false,
"status": "active",
"seen": "20260811064750",
"active": "20260811064742",
"created": "20260321083151",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"wqhosjjk0mx8oue": {
"id": "wqhosjjk0mx8oue",
"alias": "danastill",
"name": "Dana Still",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-07\/20260713150317-v6o1xlzv5y4as62.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260312055453-zyhvgyua8k65gd0.jpg",
"bio": "I'm a retired actor. Mostly stage but some TV\/film back in the 80s and 90s. I'm a prostate cancer patient\/survivor. I'm married to Jane. We have 2 Cavalier King Charles Spaniels. We live in Parksville on Vancouver Island. 🍁 ",
"timeout": false,
"status": "active",
"seen": "20260811064749",
"active": "20260811064736",
"created": "20260303115251",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"5kaccfqqsyu6gfl": {
"id": "5kaccfqqsyu6gfl",
"alias": "truecrimeexpert",
"name": "Jason Beilchick",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260302110548-bjaob2et6c6z7fd.jpeg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260303045944-a561i4qam59pxed.jpeg",
"bio": "I'm 46 years old 🌈 GEN❌80 and I'm happily married to my husband on 10-12-24.I’m also a practicing Death Witch for 35 years now ",
"timeout": false,
"status": "active",
"seen": "20260811064733",
"active": "20260811064726",
"created": "20260302110441",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"zy56n1u2xika49024vmi2xegp": {
"id": "zy56n1u2xika49024vmi2xegp",
"alias": "anthony",
"name": "Anthony Lee",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-04\/20260404073710-wl7ji48asq4zeub.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-05\/20260526123845-n093npz488pu3gs.png",
"bio": "I am a Canadian 🇨🇦🍁 developer on large scale web servers and applications and creator and developer on Hey.Café! Always ready to help any way that I can.",
"timeout": false,
"status": "active",
"seen": "20260811064757",
"active": "20260811064725",
"created": "20210414004138",
"verified": "1",
"pro": "1",
"type": "person",
"admin": "1",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cljzhcjdqqh9lbf": {
"id": "cljzhcjdqqh9lbf",
"alias": "woodchuckcanuck",
"name": "Jim Barry 🇨🇦",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260305070513-hqfcp8ul8b5tzm2.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260318073853-xf1rxlmd7emuesm.jpg",
"bio": "Lifelong woodworker and baker. A Newfoundlander who married a Nova Scotia gal. Living the rural life in NS. We are creators of woodworking plans, see WoodworkersWorkshop.com. Scrollsawn maps, lumber, kiln dried firewood, see WoodchuckCanuck.com. Supporters of products manufactured in Canada, see Manufacturedin.CA #BuyLocal #MadeInCanada",
"timeout": false,
"status": "active",
"seen": "20260811064651",
"active": "20260811064647",
"created": "20260305070118",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"eptsbruh27526zd": {
"id": "eptsbruh27526zd",
"alias": "maddragon",
"name": "Mad 🍁",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-04\/20260413055732-6cyqg4cub5hsn3h.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-05\/20260503105413-mnsljpbi5m9gmsf.jpg",
"bio": "Former supporter of Committee for an Independent Canada (yes, I'm old...er). SO glad to see that spirit returning! This is now my more general account. Politics (in the right cafés), grumbling about design and usability, and general faffing about.",
"timeout": false,
"status": "active",
"seen": "20260811064636",
"active": "20260811064616",
"created": "20260413055600",
"verified": "0",
"pro": "1",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"v6u4l9exek7b1xu": {
"id": "v6u4l9exek7b1xu",
"alias": "prysmcat",
"name": "Prysmcat",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260304123331-z529muxvzxji0cm.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-05\/20260509140624-c5d7pjansy0525w.jpg",
"bio": "AKA Steph Shangraw. Writer of always-free diverse 🏳️🌈🏳️⚧️ fantasy. GenX, non-binary, pan, disabled, neurosparkly, pagan, lover of all cats, hater of all things AI\/invasive. 💉😷 @indiediva is my roommate\/BFF !prysmcatbooks !prysmquincunx",
"timeout": false,
"status": "active",
"seen": "20260811064613",
"active": "20260811064555",
"created": "20260304112417",
"verified": "1",
"pro": "1",
"type": "creator",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"oi2nvhrzkfi4dbz1zgy8amfd1": {
"id": "oi2nvhrzkfi4dbz1zgy8amfd1",
"alias": "engadget",
"name": "Engadget (Not Official)",
"avatar": "https:\/\/storage.heycafecdn.com\/2022-01\/20220125190024-7o8jc5tcw7.png",
"header": "https:\/\/storage.heycafecdn.com\/2022-01\/20220125190032-mpw7htu34e.jpg",
"bio": "Direct feed of the public RSS feed. This is NOT an official account. Find the latest technology news and expert tech product reviews. Learn about the latest gadgets and consumer tech products. (This is a non official account)",
"timeout": false,
"status": "active",
"seen": "20260308130140",
"active": "20260811064537",
"created": "20220125185847",
"verified": "0",
"pro": "0",
"type": "news",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"4sqat6p4ibemfcn": {
"id": "4sqat6p4ibemfcn",
"alias": "cdnviolets",
"name": "Kristy V 🇨🇦",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-04\/20260412094509-soz5aseqz5wnxkl.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-06\/20260611053157-i3y7a97bkwb82ur.jpg",
"bio": "Proud Canadian\/Native Victorian... where I stash pics of the public things I love. Love sharing my watercolour paintings. All the photos have been taken by me, all the paintings have been painted by me, and are owned by me.",
"timeout": false,
"status": "active",
"seen": "20260811064531",
"active": "20260811064525",
"created": "20260301145850",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"ebpcd6imqannks0": {
"id": "ebpcd6imqannks0",
"alias": "azrael",
"name": "Azrael",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260306091228-gdag622u37t1ztx.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260306091259-wt9dqhhfiee3vaa.png",
"bio": "One of two Developers of and Writer for Hope: A Sky Full of Ghosts. We are FromHellStudio.com. Wishlist it below.",
"timeout": false,
"status": "active",
"seen": "20260811064454",
"active": "20260811064452",
"created": "20260303205617",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"1rdy2vaszg36u6x": {
"id": "1rdy2vaszg36u6x",
"alias": "sljeans",
"name": "🍁SLJeans🍁",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301155751-81d2o60ui8h58ol.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260301164410-1wtxunzsknn128e.jpg",
"bio": "I never know what to say for these, so here I am.",
"timeout": false,
"status": "active",
"seen": "20260811064411",
"active": "20260811064412",
"created": "20260301155647",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
}
},
"mutual": {
"fdgmlqvr0mbr75eipg0xlv72n": 0,
"iqq24asa83tho7u": 0,
"4y1av7shbs81u43": 0,
"5s5ia4hn8d5042jbgpxpxxyzo": 0,
"ur3gs9452rgni0h": 0,
"gvn7cdb8v4lwz7h": 0,
"vex2ki0xuv4qn4u": 0,
"psmzm3e4e96m0aa": 0,
"7ff9qn8m6ivh7kq": 0,
"55wij4f2o3y7ag5": 0,
"wqhosjjk0mx8oue": 0,
"5kaccfqqsyu6gfl": 0,
"zy56n1u2xika49024vmi2xegp": 0,
"cljzhcjdqqh9lbf": 0,
"eptsbruh27526zd": 0,
"v6u4l9exek7b1xu": 0,
"oi2nvhrzkfi4dbz1zgy8amfd1": 0,
"4sqat6p4ibemfcn": 0,
"ebpcd6imqannks0": 0,
"1rdy2vaszg36u6x": 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.