Skip to content

API

API quickstart

Make your first calls to the remake API: read a brand's numbers, start a run, and wait for it to finish. You need a terminal with curl.

Your new API key: the key hidden behind dots with Show and Copy, the private link for Claude, and the button that says you saved it Your new API key: the key hidden behind dots with Show and Copy, the private link for Claude, and the button that says you saved it

Before you start

  • A remake account with at least one brand.
  • For the run steps: a schedule on that brand, and credit in your wallet.
  • An owner account. A Viewer seat can't create keys.

The API lives at:

Base address
https://app.tryremake.com/v1

Create a key

  1. Open Your AI and go to API keys.
  2. In the API keys card, type a name in Create a key, such as "Reporting".
  3. Click Create key.
  4. In Your new API key, click Copy and store the key somewhere safe.
  5. Close the dialog with the button that says you saved it.

The key is shown once

The key starts with hf_ and is shown once only. If you lose it, revoke it and create a new one. An account can hold 5 live keys.

Make your first call

Send the key in the Authorization header on every call:

Terminal
export HF_KEY=hf_YOUR_KEY

curl -s https://app.tryremake.com/v1/me \
  -H "Authorization: Bearer $HF_KEY"

The answer shows your account, your wallet and your rate limit:

Response
{
  "account": "you@agency.example",
  "wallet": {"balance_mills": 50000, "low": false, "empty": false},
  "rate_limit": {"limit": 120, "window_seconds": 60, "per": "account"}
}

Money in the API is in mills: thousandths of a dollar. 50000 is $50.00.

Find your brands

A brand is known by its website domain. List every workspace and its brands:

Terminal
curl -s "https://app.tryremake.com/v1/workspaces" \
  -H "Authorization: Bearer $HF_KEY"

Each brand in items[].brands[] has a domain. Use it as {brand} in the calls below. Keep it in a variable, as the calls below do:

Terminal
BRAND="samsung.com"

Read a brand's numbers

Get one point per run, oldest first:

Terminal
curl -s "https://app.tryremake.com/v1/brands/$BRAND/visibility" \
  -H "Authorization: Bearer $HF_KEY"
Response
{
  "id": "samsung.com",
  "total": 12,
  "points": [
    {
      "run": 12,
      "date": "2026-09-29T06:12:44+00:00",
      "rate": 48,
      "mentions": 29,
      "asked": 60,
      "score": 70,
      "ai_models": {"chatgpt": 60, "gemini": 60, "perplexity": 40, "claude": 40}
    }
  ]
}

The answer above is cut to its newest point. Each point carries rate, your Visibility in whole percent, with mentions out of asked answers and a value per AI model in ai_models. GET /v1/brands/{brand}/dashboard returns the brand's full Overview.

A read is free.

Start a run

Starting a run takes 2 calls: one for a quote, one to confirm it.

  1. Ask for a quote. Nothing runs, and nothing is charged.

    Terminal
    curl -s -X POST \
      "https://app.tryremake.com/v1/brands/$BRAND/prompt-spend/run-now" \
      -H "Authorization: Bearer $HF_KEY"
    

    Read price_mills, balance_after_mills and would_refuse. If would_refuse isn't null, the run can't start; it says why.

  2. Confirm with the quote's quote_token, and a request_id of your own:

    Terminal
    curl -s -X POST \
      "https://app.tryremake.com/v1/brands/$BRAND/prompt-spend/run-now" \
      -H "Authorization: Bearer $HF_KEY" \
      -H "Content-Type: application/json" \
      -d '{"confirm": true,
           "quote_token": "QUOTE_TOKEN",
           "request_id": "first-run-1"}'
    

    The answer holds the run_id, with status set to queued.

The run is the brand's schedule, run once, now. It costs the quoted price, charged from your wallet one answer at a time. Answers that fail on our side are refunded.

A quote lasts 30 minutes

If the price moved before you confirmed, the answer is 409 quote_changed with a fresh quote. Nothing is charged.

Wait for the run

You can poll the run. If you've added a webhook channel, it also tells you when the run finishes. To poll, read the run:

Terminal
curl -s "https://app.tryremake.com/v1/brands/$BRAND/runs/RUN_ID" \
  -H "Authorization: Bearer $HF_KEY"
Response
{
  "token": "kX9mQ2vLp8rT3wYz",
  "status": "done",
  "score": 70,
  "completed_at": "2026-09-29T06:19:02+00:00",
  "visibility": {"rate": 48, "asked": 60, "mentions": 29}
}

The answer above is cut to the fields you poll for.

status moves from queued to running, then to done or failed. A run takes several minutes, so check every 30 seconds or so. API recipes has a loop that does this.

Check it worked

  • GET /v1/me answers with your account, not a 401.
  • The run's status reaches done.
  • In the app, the brand's Overview shows the new run's date.

Troubleshooting

I get 401 invalid_key

The key is wrong or revoked. Check you copied all of it, starting hf_.

I get 401 unauthorized

The header is missing or misspelled. Send it as Authorization: Bearer hf_…, with a capital B.

The quote answers 404

The brand has no schedule. Set one up on Budget & Spending first.

I get 429 rate_limited

Your account may make 120 calls in any 60 seconds, across all its keys and connected apps. Wait the seconds in the Retry-After header.