Ideas API

Access your product ideas with the Ideas API.

Read-only API

The Ideas API is read-only. To create, update, or delete ideas, please use the dashboard.

Endpoints

GET/v1/ideas

List all ideas

Returns a list of your product ideas.

GET/v1/ideas/:id

Retrieve an idea

Retrieves the details of an existing idea.

Idea Object

The idea object represents a single product idea in MyOpcs.

Attribute	Type	Description
`id`	string	Unique identifier (cuid)
`title`	string	The idea title (max 200 chars)
`description`	string \| null	Detailed description
`type`	string \| null	One of: app, web, pc, api, other
`priority`	string	One of: high, medium, low
`status`	string	One of: pending, approved, discarded, converted
`evaluation`	object \| null	Evaluation scores (see Evaluation object)
`createdAt`	string	ISO 8601 timestamp

Evaluation Object

The evaluation object contains scoring across four dimensions. All scores range from 1 to 5.

Attribute	Type	Description
`marketSize`	number	Market size score (1-5)
`competition`	number	Competition level (1-5)
`technicalDifficulty`	number	Technical difficulty (1-5)
`personalAdvantage`	number	Personal advantage score (1-5)

GET

List Ideas

Returns all your product ideas.

Request

Bash

curl https://api.myopcs.com/api/v1/ideas \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{}JSON

{
  "data": [
    {
      "id": "clxabc123",
      "title": "AI Writing Assistant",
      "description": "An AI-powered writing tool for developers",
      "type": "web",
      "priority": "high",
      "status": "approved",
      "evaluation": {
        "marketSize": 4,
        "competition": 3,
        "technicalDifficulty": 3,
        "personalAdvantage": 4
      },
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "clxdef456",
      "title": "Expense Tracker",
      "description": "A simple expense tracking app",
      "type": "app",
      "priority": "medium",
      "status": "pending",
      "evaluation": null,
      "createdAt": "2024-01-20T14:30:00Z"
    }
  ]
}

GET

Retrieve an Idea

Retrieves the details of an existing idea by ID.

Request

Bash

curl https://api.myopcs.com/api/v1/ideas/clxabc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{}JSON

{
  "data": {
    "id": "clxabc123",
    "title": "AI Writing Assistant",
    "description": "An AI-powered writing tool for developers",
    "type": "web",
    "priority": "high",
    "status": "approved",
    "evaluation": {
      "marketSize": 4,
      "competition": 3,
      "technicalDifficulty": 3,
      "personalAdvantage": 4
    },
    "createdAt": "2024-01-15T10:30:00Z"
  }
}