Docs / Get started

What Build is

Build is one API for marketplace and ad data, with the same call shape and field names on every platform.

On this page

AmazonReads ✓ · Writes ✓Google AdsReads ✓ · Writes —

What it is

Build connects the marketplace and ad accounts you already have and answers questions about them over one API. You send one POST to a tool, with one key, and get rows back in the same fields whichever platform the account is on.

Amazon and Google Ads are live. Other platforms follow the same call shape when they launch.

Make your first call

  1. Get a key

    Open Keys in the console, name the key, and choose what it can reach.

  2. Keep it in your tool's secrets

    Store it as BUILD_API_KEY, so your prompts and code never contain the key itself.

  3. POST to a tool

    The tool name is in the path. The body names the account and the dates.

curl -X POST https://build-api.sellermate.ai/v1/tools/get_inventory \
-H "X-API-Key: $BUILD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":"acct_123"}'

The call shape is illustrative until the contract is final. The sandbox key returns demo data and is read-only.

What you send

NameTypeDescription
accountRequiredstringThe account to read. A key only reaches the accounts you chose when you created it.
startdateFirst day, as YYYY-MM-DD. For tools that report over a period.
enddateLast day, as YYYY-MM-DD.

What comes next

Placeholder Fails a strict build (DOCS_STRICT=1).

To write: a screenshot of the console Keys screen, a short list of what the Free plan includes, and the link to Get a key

Questions

Can Build change things in my accounts?

On Amazon accounts only, with caps, a dry run and undo. Google Ads and the platforms that follow are read-only.

Which platforms are live?

Amazon and Google Ads. Walmart, Flipkart, TikTok Shop and Meta Ads are coming soon.

Do I need an SDK?

No. Each tool is one POST with a JSON body, so curl, a fetch call or your AI tool's HTTP step all work.

Last updated 30 Oct 2026