---
title: "Get competitive landscape"
method: GET
path: "/api/v1/projects/{id}/landscape"
tags: ["API v1"]
---

# Get competitive landscape

`GET /api/v1/projects/{id}/landscape`

## Request

- Base URL: `https://api.rivalize.ai`
- URL: `https://api.rivalize.ai/api/v1/projects/{id}/landscape`
- Auth: HTTP bearer

Current or stored weekly activity × importance positions. Set format=markdown for agent-ready text.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `week` string
- `format` 'json' | 'markdown'

## Response `200`

The competitive landscape in the `data` envelope, or agent-ready Markdown with format=markdown.

- object
  - `data` object, required

## Other responses

- `400`: Error. Carries a stable `code`, a human `message`, the HTTP `status`, and the `request_id` (also on the x-request-id response header).
- `402`: Error. Carries a stable `code`, a human `message`, the HTTP `status`, and the `request_id` (also on the x-request-id response header).
- `404`: Error. Carries a stable `code`, a human `message`, the HTTP `status`, and the `request_id` (also on the x-request-id response header).

---

[API](https://skmtc.dev/rivalize/apis/rivalize-api.md) · [All operations](https://skmtc.dev/rivalize/apis/rivalize-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rivalize/apis/rivalize-api/revisions/1c705ba465eb?raw)
