---
title: "List Opportunities"
method: GET
path: "/api/v1/social/websites/{website_id}/opportunities"
tags: ["social_opportunities"]
---

# List Opportunities

`GET /api/v1/social/websites/{website_id}/opportunities`

## Request

- Base URL: `https://api.seoproai.co`
- URL: `https://api.seoproai.co/api/v1/social/websites/{website_id}/opportunities`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://dajosjnaalanhqksxrpe.supabase.co/auth/v1/authorize`, token URL `https://dajosjnaalanhqksxrpe.supabase.co/auth/v1/token`)

Return latest opportunities for a website with enhanced filtering and pagination.

## Path parameters

- `website_id` integer, required

## Query parameters

- `platform` string, nullable
- `opportunity_type` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- OpportunitiesResponse: Response model for paginated opportunities.
  - `opportunities` OpportunityOut[], required
    - `id` integer, required
    - `title` string, required
    - `platform` string, required
    - `platform_community` string, nullable
    - `url` string, required
    - `opportunity_type` string
    - `parent_post_id` string, nullable
    - `matched_keywords` string[]
    - `matched_competitors` string[]
    - `relevance_score` number, nullable
    - `context_snippet` string, nullable
    - `engagement_metrics` object
    - `author_info` object
    - `platform_metadata` object
    - `status` string, required
    - `post_created_at` string, nullable
    - `generated_comment` string, nullable
  - `total` integer, required
  - `hasMore` boolean, required
  - `offset` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoproai/apis/seopro-ai.md) · [All operations](https://skmtc.dev/seoproai/apis/seopro-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/seoproai/apis/seopro-ai/revisions/5b4b6391ddc9?raw)