Docs / Get started

First call in 60 seconds

Make a first real call to Build with the sandbox key or your own, and read the answer.

On this page

Before you start

  • A Build account and a key. The sandbox key is enough; see Get a key.
  • Your key in an environment variable named BUILD_API_KEY.
  • One tool to call. This page uses get_campaign_performance.

Send the request

One POST to the tool, the key in the X-API-Key header, and a JSON body with the account and the dates.

curl -X POST https://build-api.sellermate.ai/v1/tools/get_campaign_performance \
-H "X-API-Key: $BUILD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":"acct_123","start":"2026-10-01","end":"2026-10-28"}'

The call shape is illustrative until the contract is final.

Read the answer

Every row has the same fields on Amazon and Google Ads. An answer looks like this:

{
"rows": [
  {
    "platform": "amazon",
    "account_id": "amz_northwind",
    "campaign_name": "SP - Bottles - Exact",
    "spend": 1842.10,
    "clicks": 2210,
    "orders": 161,
    "sales": 6120.40,
    "acos": 0.301,
    "currency": "USD"
  }
],
"meta": { "data_as_of": "2026-10-30T06:00:00Z" }
}

data_as_of says how fresh the answer is. Amazon sales keep moving for up to 14 days, and Build re-pulls those days until they settle.

Placeholder Fails a strict build (DOCS_STRICT=1).

To write: replace the sample with a real sandbox response: the exact envelope (where data_as_of and settling_from sit), real field types, and one real row

If it fails

A 429 means you went over the plan's requests per minute. The body says when to retry:

{ "error": "rate_limited", "retry": 12, "upgrade": "https://build.sellermate.ai/pricing" }

Wait that many seconds and send it again. Limits per plan are in Plans and limits.

Placeholder Fails a strict build (DOCS_STRICT=1).

To write: one more common error and its fix, for example a missing or wrong key, with the real status and body

Next steps

Last updated 30 Oct 2026