---
title: "Get build ideas"
method: GET
path: "/v1/suggestions"
tags: ["suggestions"]
---

# Get build ideas

`GET /v1/suggestions`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/suggestions`
- Auth: HTTP bearer

Returns ideas for a tool to build: each a website and one task on it, from a reviewed set of popular US websites that Pomerado has no public tool for that task yet and that a Pomerado browser opened without being blocked. Ideas come from different categories in random order; ask again with exclude for others.

## Query parameters

- `count` string
- `exclude` string

## Response `200`

Build ideas

- BuildSuggestions
  - `suggestions` BuildSuggestion[], required
    - `id` string, required
    - `site_name` string, required: The website's name
    - `site_url` string, required: Where the website starts
    - `task` string, required: What the tool would do, verb first
    - `inputs` string, required: What you would give the tool
    - `outputs` string, required: What the tool would return
    - `category` 'shopping' | 'groceries' | 'travel' | 'outdoors' | 'home' | 'jobs' | 'records' | 'money' | 'health' | 'learning' | 'events' | 'food' | 'work' | 'tech' | 'sports' | 'cars' | 'entertainment' | 'local', required
    - `sign_in` 'none' | 'own_account', required: none: the task needs no sign-in. own_account: the build asks you to sign in with your own account on the website

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

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