Skip to content
GET /v1/search

Search

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/lemmy-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/lemmy-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/lemmy-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/lemmy-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/lemmy-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "posts": [
            {
                "post": {
                    "id": 4544125,
                    "url": "https://lemmy.ml/pictrs/image/52bd0a21-b549-4dbe-ae42-0c8613e40e14.jpeg",
                    "body": "",
                    "name": "It either runs on Linux or refund",
                    "nsfw": false,
                    "ap_id": "https://lemmy.ml/post/4488445",
                    "local": false,
                    "locked": false,
                    "deleted": false,
                    "removed": false,
                    "published": "2023-09-06T09:10:32.206827Z",
                    "creator_id": 344054,
                    "language_id": 0,
                    "community_id": 37,
                    "thumbnail_url": "https://lemmy.ml/pictrs/image/56df087b-fc0b-405e-85bd-25ae9f60bb47.jpeg",
                    "featured_local": false,
                    "featured_community": false
                },
                "read": false,
                "saved": false,
                "counts": {
                    "score": 2952,
                    "post_id": 4544125,
                    "upvotes": 3037,
                    "comments": 307,
                    "downvotes": 85,
                    "published": "2023-09-06T09:10:32.206827Z",
                    "newest_comment_time": "2026-04-02T10:21:26.407231Z"
                },
                "hidden": false,
                "creator": {
                    "id": 344054,
                    "name": "Uluganda",
                    "local": false,
                    "banned": false,
                    "deleted": false,
                    "actor_id": "https://lemmy.ml/u/Uluganda",
                    "published": "2023-06-22T11:29:04.894574Z",
                    "bot_account": false,
                    "instance_id": 3
                },
                "community": {
                    "id": 37,
                    "icon": "https://lemmy.ml/pictrs/image/q98XK4sKtw.png",
                    "name": "linux",
                    "nsfw": false,
                    "local": false,
                    "title": "Linux",
                    "hidden": false,
                    "deleted": false,
                    "removed": false,
                    "updated": "2022-06-18T17:36:20.924834Z",
                    "actor_id": "https://lemmy.ml/c/linux",
                    "published": "2019-06-01T15:07:36.179766Z",
                    "visibility": "Public",
                    "description": "From Wikipedia, the free encyclopedia\n\nLinux is a family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991 by Linus Torvalds. Linux is typically packaged in a Linux distribution (or distro for short).\n\nDistributions include the Linux kernel and supporting system software and libraries, many of which are provided by the GNU Project. Many Linux distributions use the word \"Linux\" 
…