Agentic commerce

A product question. A sourced answer.

Variants, prices and availability, with the source attached.

Synthetic catalog data · not a retrieval result
02 / Inspect the example
Example answer · calculated from fictional values

Which variants does this example mark available?

Small / Navy, Medium / Navy are marked available in this synthetic example. 1 example value is unknown.

USD 32.00USD 34.00fictional example prices

No live source, price observation or inventory state is represented.

Agent setup brief
Setup instructions · contains no credentials
Use the datawebot HTTP API at https://www.datawebot.com/api/product.
Read https://www.datawebot.com/docs/api/reference and https://www.datawebot.com/openapi.json before making requests.
Use DATAWEBOT_API_KEY from the owner's secret environment. Never print it or put it in a URL.
The URL below is a reserved placeholder. Replace it only with a storefront URL that the owner is authorized to use and that the service currently supports. Do not submit the placeholder.
Task: inspect the product and its reported variants, prices and availability.
Budget: at most 2 page visits and 2 credits. Do not increase it without the owner's authorization.
1. POST /estimate with the input below. Stop on validation, balance or permission errors.
2. POST /runs with the same input and a unique Idempotency-Key for this task. Preserve that key and run.id across retries; never create duplicate work after an uncertain response.
3. GET /runs/{id}. Respect next_poll_after. If action_required is present, ask the owner. Yield while Processing and resume with the saved ID.
4. When Ready, GET /runs/{id}/results and follow next_cursor until null. Stop and explain Unavailable, expired or failed results.
5. Report returned variants, currencies, source URLs, retrieval times, completeness and warnings. Null means unknown. An unavailable variant is not evidence of future stock. Do not invent missing values.
Input: {"url":"https://merchant.example/products/item","operation":"product","maxPages":2,"maxCredits":2,"paginationPages":1,"productPages":0,"categoryPages":0}
Agent-ready contract

Small responses. Durable work.

An agent does not need to hold a browser session open. It can estimate a bounded request, persist the returned ID, yield while processing, and retrieve paginated JSON when ready.

Read the agent guide
Idempotent

A stable request key recovers the original extraction after uncertain transport.

Budgeted

Per-run and per-key daily ceilings enforce the authority granted by the owner.

Recoverable

Status, next action and polling hints tell the agent whether to wait or escalate.

Traceable

Results retain source identity, retrieval time, currency and completeness notes.

One upstream service, many downstream uses.

Shopping, research, catalogue and pricing agents can use the same source-faithful records without datawebot. making their decisions.

Shopping research

Retrieve current source observations for products an agent is evaluating.

Catalogue work

Bring source identifiers, variants and prices into an enrichment pipeline.

Market analysis

Collect bounded observations that your own workflow can normalize and compare.

A few useful answers.

Provision your agent.

Start free, create a constrained key and make one bounded request.

Create an agent key