Hey.Café Endpoint Docs
Get Search Conversations
get_search_ conversations
Searches the system for conversations based on a query. You can use a space like 'pokemon fan' to search for any use of 'pokemon' and the word 'fan' even when content is between. It also can search down to accounts or cafès by using '@hey' or '!pokemon' to only show content posted by that account or in that café. You can also multi search separate matches in one result by putting each search term inside [] for example to find all shared youtube video formats you can search for [https://youtube.com watch] [https://youtube.com live] [https://youtu.be].
https://endpoint.hey.cafe/get_search_conversationshttps://endpoint.hey.cafe/api/search_conversationsVariables
A list of variables needed to make the call work, they can be provided via the URL or POST.
searchThe search query.
search_rawYou can use this if you want to provide the text without encoding.
countNumber of items to show.
startOffset for search results.
followingIf using an account API token if provided as TRUE we will only search content from accounts being followed by the API account.
orderChange the search index key order from by weight to by item date, allowing you to always fetch the most recent result for each word break in the query even if not the best item score. Values are 'weight' and 'date' with the option weight being default.
directIf set to true you can only use this with SINGLE word break searches like for example 'attach:image' type queries or 'bird' and it will fetch direct match within the same limit from the search key table as what will be returned from the conversations table. Good for loading all a conversations with something specific going further back than default search will let you.
Example Response
https://endpoint.hey.cafe/get_search_conversations?search_raw=minecraft{
"system_api_endpoint": "endpoint-009.hey.cafe",
"system_api_timestamp": "20260708170838",
"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,
"conversations": {
"khk55mmkm0zvapx": {
"id": "khk55mmkm0zvapx",
"account": {
"id": "b0xt0dly3r0yww8",
"alias": "dabidown",
"name": "Dabi and Jas. 🌍🌏🌎🇺🇳",
"avatar": "https:\/\/storage.heycafecdn.com\/2026-03\/20260319061640-h97k0dsvbrr3lfh.png",
"header": "https:\/\/storage.heycafecdn.com\/2026-03\/20260319070442-hhjpxyywn8is155.jpeg",
"bio": "Grandfather residing on Oregon’s North Coast. Kahu to Dabi a 60 m\/o MAS. Hobby artist. Former zookeeper. Minecraft Bedrock and needle felting noob. Leaning towards misanthropy. A contrarian at times. No politics. I know USerlandia is rekt. Elbows Up NPR 🇨🇿🇨🇦🇺🇦🇪🇺🇲🇽🇬🇱🐧 🇵🇸🌺PBS Resist Antifa ",
"timeout": false,
"status": "active",
"seen": "20260708164000",
"active": "20260708162017",
"created": "20260319061513",
"verified": "0",
"pro": "0",
"type": "person",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cafe": false,
"info_table": "b",
"info_score": "0",
"info_safespace": "0",
"info_pinned": "0",
"info_hidden_cafe": "0",
"info_hidden_global": "0",
"info_updated": "0",
"info_locked": "0",
"info_draft": "0",
"info_language": "en",
"date_created": "20260706185050",
"date_activity": "20260706185050",
"contents": "Minecraft under new management. Good or bad? #Minecraft #Mojang #XBox https:\/\/youtu.be\/8e9_S9Hac3o?si=WSma4noW22lO9eCq",
"count_comments": "0",
"count_you_comments": "0",
"count_reactions": "0",
"count_you_reactions": "0",
"you_last_reaction": false,
"attachments": false,
"tag": false,
"reactions": false
},
"eh2k8pnqebsccj8": {
"id": "eh2k8pnqebsccj8",
"account": {
"id": "ijv3lw6d4hk0idj",
"alias": "verge",
"name": "The Verge (Not Official)",
"avatar": "https:\/\/storage.heycafecdn.com\/2023-05\/20230504185831-xbx9qzqhtpkxfh1.jpg",
"header": "https:\/\/storage.heycafecdn.com\/2023-05\/20230504185825-1h2s8j300a3vqyd.jpeg",
"bio": "Direct feed of the public RSS feed. This is NOT an official account. The Verge covers life in the future. (This is a non official account)",
"timeout": false,
"status": "active",
"seen": "20260308130152",
"active": "20260708145238",
"created": "20230504185157",
"verified": "0",
"pro": "0",
"type": "news",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cafe": false,
"info_table": "d",
"info_score": "0",
"info_safespace": "0",
"info_pinned": "0",
"info_hidden_cafe": "0",
"info_hidden_global": "0",
"info_updated": "0",
"info_locked": "0",
"info_draft": "0",
"info_language": "en",
"date_created": "20260607095138",
"date_activity": "20260607095138",
"contents": "Minecraft Dungeons 2 gets a September release date https:\/\/www.theverge.com\/games\/939551\/minecraft-dungeons-ii-2-release-date-trailer",
"count_comments": "0",
"count_you_comments": "0",
"count_reactions": "0",
"count_you_reactions": "0",
"you_last_reaction": false,
"attachments": false,
"tag": false,
"reactions": false
},
"ovp1k4h7u37o8fe": {
"id": "ovp1k4h7u37o8fe",
"account": {
"id": "r1whfuznqojzqek",
"alias": "hermitcraft",
"name": "Fan Made Hermitcraft Bot",
"avatar": "https:\/\/storage.heycafecdn.com\/2024-06\/20240604145010-0eovs45ji9ajkoe.png",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_account.jpg",
"bio": "I post new videos to the !hermitcraft café.",
"timeout": false,
"status": "active",
"seen": "20260303175000",
"active": "20260708124038",
"created": "20240604144730",
"verified": "0",
"pro": "0",
"type": "robot",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cafe": {
"id": "uiyvfmbctli6v1w",
"alias": "hermitcraft",
"name": "Hermitcraft",
"avatar": "https:\/\/storage.heycafecdn.com\/2024-03\/20240328175354-lg9gjl1uqczpvga.png",
"header": "https:\/\/storage.heycafecdn.com\/2025-11\/20251111150418-gue1n1pny4dap4s.jpeg",
"bio": "Hermitcraft is primarily a building and redstone-focused server. Members are well known in the Minecraft community for their artistic and technical proficiency in the game, and many of them are pioneers in their specialized crafts.",
"website": "false",
"members": "22",
"status": "active",
"type": "gaming",
"mode": "public",
"view": "normal",
"hidden": "0",
"restricted": "0",
"activity": "20260708124038",
"created": "20240328175020",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"require_tag": "0",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false,
"you_subscribed": false,
"you_notifications": false,
"you_favourite": false,
"them_member": true,
"them_banned": false,
"them_request": false,
"them_moderator": true,
"them_admin": true,
"them_subscribed": false,
"them_notifications": true,
"them_favourite": false
},
"info_table": "d",
"info_score": "0",
"info_safespace": "0",
"info_pinned": "0",
"info_hidden_cafe": "0",
"info_hidden_global": "0",
"info_updated": "0",
"info_locked": "0",
"info_draft": "0",
"info_language": "en",
"date_created": "20260502084738",
"date_activity": "20260502084738",
"contents": "A Cozy Minecraft Interior! Hermitcraft 11 - Episode 17 https:\/\/www.youtube.com\/watch?v=3MYc_8AKu60",
"count_comments": "0",
"count_you_comments": "0",
"count_reactions": "0",
"count_you_reactions": "0",
"you_last_reaction": false,
"attachments": false,
"tag": {
"id": "wq4ubwwxwg1qac2",
"account": "r1whfuznqojzqek",
"cafe": "uiyvfmbctli6v1w",
"name": "* Season 11 - New Episodes",
"emoji": "🎬",
"staff": "false",
"collapsed": "false"
},
"reactions": false
},
"lbagugorirbd23x": {
"id": "lbagugorirbd23x",
"account": {
"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": "20260708153836",
"created": "20220125185847",
"verified": "0",
"pro": "0",
"type": "news",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cafe": false,
"info_table": "c",
"info_score": "0",
"info_safespace": "0",
"info_pinned": "0",
"info_hidden_cafe": "0",
"info_hidden_global": "0",
"info_updated": "0",
"info_locked": "0",
"info_draft": "0",
"info_language": "en",
"date_created": "20260321094142",
"date_activity": "20260321094142",
"contents": "A Minecraft theme park will open in London in 2027 https:\/\/www.engadget.com\/gaming\/a-minecraft-theme-park-will-open-in-london-in-2027-173000917.html?src=rss",
"count_comments": "0",
"count_you_comments": "0",
"count_reactions": "0",
"count_you_reactions": "0",
"you_last_reaction": false,
"attachments": false,
"tag": false,
"reactions": false
},
"drxy7j7j790r5pg": {
"id": "drxy7j7j790r5pg",
"account": {
"id": "r1whfuznqojzqek",
"alias": "hermitcraft",
"name": "Fan Made Hermitcraft Bot",
"avatar": "https:\/\/storage.heycafecdn.com\/2024-06\/20240604145010-0eovs45ji9ajkoe.png",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_account.jpg",
"bio": "I post new videos to the !hermitcraft café.",
"timeout": false,
"status": "active",
"seen": "20260303175000",
"active": "20260708124038",
"created": "20240604144730",
"verified": "0",
"pro": "0",
"type": "robot",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cafe": {
"id": "uiyvfmbctli6v1w",
"alias": "hermitcraft",
"name": "Hermitcraft",
"avatar": "https:\/\/storage.heycafecdn.com\/2024-03\/20240328175354-lg9gjl1uqczpvga.png",
"header": "https:\/\/storage.heycafecdn.com\/2025-11\/20251111150418-gue1n1pny4dap4s.jpeg",
"bio": "Hermitcraft is primarily a building and redstone-focused server. Members are well known in the Minecraft community for their artistic and technical proficiency in the game, and many of them are pioneers in their specialized crafts.",
"website": "false",
"members": "22",
"status": "active",
"type": "gaming",
"mode": "public",
"view": "normal",
"hidden": "0",
"restricted": "0",
"activity": "20260708124038",
"created": "20240328175020",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"require_tag": "0",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false,
"you_subscribed": false,
"you_notifications": false,
"you_favourite": false,
"them_member": true,
"them_banned": false,
"them_request": false,
"them_moderator": true,
"them_admin": true,
"them_subscribed": false,
"them_notifications": true,
"them_favourite": false
},
"info_table": "b",
"info_score": "0",
"info_safespace": "0",
"info_pinned": "0",
"info_hidden_cafe": "0",
"info_hidden_global": "0",
"info_updated": "0",
"info_locked": "0",
"info_draft": "0",
"info_language": "en",
"date_created": "20260301103138",
"date_activity": "20260301103138",
"contents": "Landscaping my Minecraft Base! Hermitcraft 11 - Episode 12 https:\/\/www.youtube.com\/watch?v=Zo-33zN07gA",
"count_comments": "0",
"count_you_comments": "0",
"count_reactions": "0",
"count_you_reactions": "0",
"you_last_reaction": false,
"attachments": false,
"tag": {
"id": "wq4ubwwxwg1qac2",
"account": "r1whfuznqojzqek",
"cafe": "uiyvfmbctli6v1w",
"name": "* Season 11 - New Episodes",
"emoji": "🎬",
"staff": "false",
"collapsed": "false"
},
"reactions": false
},
"i0v9pka3acikxaf": {
"id": "i0v9pka3acikxaf",
"account": {
"id": "r1whfuznqojzqek",
"alias": "hermitcraft",
"name": "Fan Made Hermitcraft Bot",
"avatar": "https:\/\/storage.heycafecdn.com\/2024-06\/20240604145010-0eovs45ji9ajkoe.png",
"header": "https:\/\/storage.heycafecdn.com\/defaults\/header_account.jpg",
"bio": "I post new videos to the !hermitcraft café.",
"timeout": false,
"status": "active",
"seen": "20260303175000",
"active": "20260708124038",
"created": "20240604144730",
"verified": "0",
"pro": "0",
"type": "robot",
"admin": "0",
"moderator": "0",
"language": "en",
"public_view": "1",
"public_comment": "1",
"public_react": "1"
},
"cafe": {
"id": "uiyvfmbctli6v1w",
"alias": "hermitcraft",
"name": "Hermitcraft",
"avatar": "https:\/\/storage.heycafecdn.com\/2024-03\/20240328175354-lg9gjl1uqczpvga.png",
"header": "https:\/\/storage.heycafecdn.com\/2025-11\/20251111150418-gue1n1pny4dap4s.jpeg",
"bio": "Hermitcraft is primarily a building and redstone-focused server. Members are well known in the Minecraft community for their artistic and technical proficiency in the game, and many of them are pioneers in their specialized crafts.",
"website": "false",
"members": "22",
"status": "active",
"type": "gaming",
"mode": "public",
"view": "normal",
"hidden": "0",
"restricted": "0",
"activity": "20260708124038",
"created": "20240328175020",
"public_react": "1",
"public_comment": "1",
"public_view": "1",
"member_create": "1",
"member_react": "1",
"member_comment": "1",
"member_feed": "1",
"require_tag": "0",
"you_member": false,
"you_banned": false,
"you_request": false,
"you_moderator": false,
"you_admin": false,
"you_subscribed": false,
"you_notifications": false,
"you_favourite": false,
"them_member": true,
"them_banned": false,
"them_request": false,
"them_moderator": true,
"them_admin": true,
"them_subscribed": false,
"them_notifications": true,
"them_favourite": false
},
"info_table": "b",
"info_score": "0",
"info_safespace": "0",
"info_pinned": "0",
"info_hidden_cafe": "0",
"info_hidden_global": "0",
"info_updated": "0",
"info_locked": "0",
"info_draft": "0",
"info_language": "en",
"date_created": "20260218084638",
"date_activity": "20260218084638",
"contents": "Fire Hazard :: Minecraft Hermitcraft https:\/\/www.youtube.com\/watch?v=j_LS2qb4kvg",
"count_comments": "0",
"count_you_comments": "0",
"count_reactions": "0",
"count_you_reactions": "0",
"you_last_reaction": false,
"attachments": false,
"tag": {
"id": "wq4ubwwxwg1qac2",
"account": "r1whfuznqojzqek",
"cafe": "uiyvfmbctli6v1w",
"name": "* Season 11 - New Episodes",
"emoji": "🎬",
"staff": "false",
"collapsed": "false"
},
"reactions": false
}
},
"searches": [
"minecraft"
]
}
}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.