Search

Find similar URLs

get

Returns URLs semantically similar to a given URL using vector similarity search.

Query parameters

pagenumber · nullableOptional

limitnumber · nullableOptional

sortBystringOptional

sortOrderstring · enumOptionalPossible values:

urlstringRequired

thresholdnumber · nullableOptional

urlTypestring · enumOptionalPossible values:

Header parameters

X-Semble-ClientstringOptional

A short identifier for your integration (e.g. my-plugin, mcp). Please set this if you are building an integration — it helps Semble understand which tools people use. Values are lowercased before being recorded, so MyPlugin and myplugin are the same client. After lowercasing the value must match ^[a-z0-9][a-z0-9_-]{0,31}$; values that do not are ignored, and the client is inferred from the auth method instead.

Example: my-pluginPattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$

Responses

200

200

application/json

get/network.cosmik.search.getSimilarUrls

GET /xrpc/network.cosmik.search.getSimilarUrls?url=text HTTP/1.1
Host: api.semble.so
Accept: */*

200

200

{
  "urls": [
    {
      "url": "text",
      "metadata": {
        "url": "text",
        "title": "text",
        "description": "text",
        "author": "text",
        "publishedDate": "text",
        "siteName": "text",
        "imageUrl": "text",
        "type": "text",
        "retrievedAt": "text",
        "doi": "text",
        "isbn": "text"
      },
      "urlLibraryCount": 1,
      "urlInLibrary": true,
      "urlConnectionCount": 1,
      "urlIsConnected": true
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "totalCount": 1,
    "hasMore": true,
    "limit": 1
  }
}

Semantic search

get

Returns URLs matching a natural-language query using vector search, optionally scoped to a user and filtered by type.

Query parameters

pagenumber · nullableOptional

limitnumber · nullableOptional

sortBystringOptional

sortOrderstring · enumOptionalPossible values:

querystringRequired

thresholdnumber · nullableOptional

urlTypestring · enumOptionalPossible values:

identifierstringOptional

Header parameters

X-Semble-ClientstringOptional

A short identifier for your integration (e.g. my-plugin, mcp). Please set this if you are building an integration — it helps Semble understand which tools people use. Values are lowercased before being recorded, so MyPlugin and myplugin are the same client. After lowercasing the value must match ^[a-z0-9][a-z0-9_-]{0,31}$; values that do not are ignored, and the client is inferred from the auth method instead.

Example: my-pluginPattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$

Responses

200

200

application/json

get/network.cosmik.search.semantic

GET /xrpc/network.cosmik.search.semantic?query=text HTTP/1.1
Host: api.semble.so
Accept: */*

200

200

{
  "urls": [
    {
      "url": "text",
      "metadata": {
        "url": "text",
        "title": "text",
        "description": "text",
        "author": "text",
        "publishedDate": "text",
        "siteName": "text",
        "imageUrl": "text",
        "type": "text",
        "retrievedAt": "text",
        "doi": "text",
        "isbn": "text"
      },
      "urlLibraryCount": 1,
      "urlInLibrary": true,
      "urlConnectionCount": 1,
      "urlIsConnected": true
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "totalCount": 1,
    "hasMore": true,
    "limit": 1
  }
}

Search AT Protocol accounts

get

Searches for AT Protocol user accounts by handle or display name.

Query parameters

termstringOptional

qstringOptional

limitnumber · nullableOptional

cursorstringOptional

Header parameters

X-Semble-ClientstringOptional

A short identifier for your integration (e.g. my-plugin, mcp). Please set this if you are building an integration — it helps Semble understand which tools people use. Values are lowercased before being recorded, so MyPlugin and myplugin are the same client. After lowercasing the value must match ^[a-z0-9][a-z0-9_-]{0,31}$; values that do not are ignored, and the client is inferred from the auth method instead.

Example: my-pluginPattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,31}$

Responses

200

200

application/json

cursorstringOptional

get/network.cosmik.search.getAccounts

GET /xrpc/network.cosmik.search.getAccounts HTTP/1.1
Host: api.semble.so
Accept: */*

200

200

{
  "cursor": "text",
  "actors": [
    {
      "did": "text",
      "handle": "text",
      "displayName": "text",
      "description": "text",
      "avatar": "text",
      "associated": {
        "chat": {
          "allowIncoming": "all"
        }
      },
      "indexedAt": "text",
      "createdAt": "text",
      "viewer": {
        "muted": true,
        "blockedBy": true,
        "blocking": "text",
        "following": "text",
        "followedBy": "text"
      },
      "labels": [],
      "verification": null,
      "status": null
    }
  ]
}