Quickstart

Create a key, send your first request, and read the response.

Updated 2026-05-24
4 min read

Five minutes from zero to a successful API call. You'll need an active Forvibe account and at least one project.

1

Create an API key

Open Account → API Keys, click Create API Key, give it a name, and copy the key (starts with fvk_live_). The plaintext is shown once — store it somewhere safe.

Same key works for MCP and REST. Choose scopes carefully — the key inherits whatever you grant.

2

Make your first request

List your projects with one cURL call:

bash
curl -s https://forvibe.app/api/v1/projects \
  -H "Authorization: Bearer fvk_live_YOUR_KEY"

You'll get a response shaped like:

json
{
  "data": [
    {
      "id": "f5e0...",
      "name": "My App",
      "subdomain": "myapp",
      "store_connected_appstore": true,
      ...
    }
  ],
  "count": 1
}
3

Pick a project and read its listing

Drop a project UUID from step 2 into this request to read the App Store listing for English (US):

bash
curl -s https://forvibe.app/api/v1/projects/$PROJECT_ID/listings/appstore/en-US \
  -H "Authorization: Bearer fvk_live_YOUR_KEY"
4

Make a write request

Add a new tracked keyword (the response is the row that was inserted):

bash
curl -s -X POST \
  https://forvibe.app/api/v1/projects/$PROJECT_ID/keywords \
  -H "Authorization: Bearer fvk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_type":"appstore","keyword":"focus timer","country":"US"}'

Next steps

  • Read Authentication for the scope model.
  • Skim Errors so your retry logic is correct.
  • If you're calling AI endpoints (translation, review simulation), read Async jobs.