Public API

Let your Agent list products for you.

You provide each product domain, description, primary product type, and one authoritative email. Your Agent handles the API calls; you only open the one-time verification email.

Copy this instruction to your Agent

Paste it into any Agent that can call web APIs. It contains the complete safe workflow and links to the live contract.

Help me submit products to ShareBid's free Share Board.

1. Read https://sharebid.win/v1/help and https://sharebid.win/v1/openapi.json before calling the API.
2. Ask me for one authoritative email and, for each product, its public domain, a 1–180 character description, and exactly one category allowed by the live contract. Choose the category by the product's primary use, not its underlying technology.
3. POST the batch to https://sharebid.win/v1/products/batch exactly as the live contract specifies. Do not request a password, login, domain-verification record, or mailbox access.
4. After a 202 response, tell me to open the one-time ShareBid verification email myself. Do not ask me to forward the verification link.
5. Keep requestKey and statusUrl private. After I confirm that I opened the email, poll the returned statusUrl verbatim until the request is completed, partially_completed, or failed, then report every product result.
6. Never try to overwrite an existing product. If ShareBid returns authority_mismatch or legacy_product_locked, stop and explain the result instead of retrying with another email.

What happens next

1 · Give the details

Your Agent asks for one authoritative email plus each product domain, 1–180 character description, and one primary product type.

2 · Verify once

ShareBid emails you a one-time link. Open it yourself; never give your mailbox or password to the Agent.

3 · Receive the results

Your Agent privately polls the returned status URL and reports the result for every product.

Technical resources for Agents

These machine-readable files support the copied instruction. Most people do not need to read them directly.

Machine-readable help (JSON) ↗OpenAPI 3.1 contract ↗

return to ShareBid →