datawebotExtraction guide
A product-data loop for your agent
Answer a product question from a bounded extraction.
01 / INPUTProduct URL + 2-credit ceiling
02 / YOUR WORKFLOWEstimate → submit → wait → retrieve
03 / OUTPUTVariants + prices + source evidence
Keep the right fields.
Workflow field map| Field / step | Input | Rule |
|---|---|---|
| Task identity | run.id + idempotency key | Save both before yielding. |
| Result pages | products + next_cursor | Continue until the cursor is null. |
| Answer | variants + provenance | Cite the observation; preserve unknown values. |
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.
Before you use the output
The saved example reports availability, not inventory quantity. Reordering, schedules and price changes require your own systems and authorization.
Check one record first.
Start with the smallest useful scope. Compare the returned record with its source, confirm variant identity and inspect missing fields before applying the mapping to a larger dataset.
Keep extraction warnings and the retrieval timestamp with downstream output. When a required field is missing, leave it unresolved or return to the source; do not fill it from an assumption.
01Create a keySet run + daily limits02Copy setupUse your HTTP-capable agent03Run a taskInspect the returned evidence
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}