New Orchly MCP & API are live. Build custom workflows with your SEO & AI visibility data.
GET /recommendations

List recommendations

Planner opportunities, including content gaps. Requires `tasks:read`.

Authenticate with Authorization: Bearer obk_live_xxx. See authentication.

Parameters

NameInTypeRequiredDescription
X-Workspace-Id header string required The workspace to scope the request to. Can also be passed as a `workspace_id` query parameter.
status query string optional
type query string optional
limit query integer optional Maximum number of items to return.

Responses

200 OK
FieldTypeDescription
workspace_id string
recommendations object[]

Example request

curl --request GET \
  --url https://app.orchly.ai/api/v1/recommendations \
  --header 'Authorization: Bearer obk_live_xxx' \
  --header 'X-Workspace-Id: ws_xxx'
const res = await fetch(`https://app.orchly.ai/api/v1/recommendations`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer obk_live_xxx',
    'X-Workspace-Id': 'ws_xxx',
  },
});
const data = await res.json();
import requests

resp = requests.get(
    "https://app.orchly.ai/api/v1/recommendations",
    headers={
        "Authorization": "Bearer obk_live_xxx",
        "X-Workspace-Id": "ws_xxx",
    },
)
data = resp.json()

Example response

A 200 response. Dynamic fields are shown as their type.

{
  "workspace_id": "string",
  "recommendations": [
    {}
  ]
}