Return Policy Extraction

Read a shop's return policy: the return window, conditions, exclusions and how to return.

Pay by wallet (x402) AI-generated return-policy-extract

Example

Example answer

{
  "retailer": "example.com",
  "conditions": [
    "No return policy information found on this page"
  ],
  "exclusions": null,
  "policy_url": "https://example.com",
  "contact_info": null,
  "free_returns": null,
  "process_steps": null,
  "refund_method": null,
  "restocking_fee": null,
  "exchange_available": null,
  "return_window_days": null,
  "store_credit_option": null,
  "international_returns": null
}

Inputs

Field	Type	Required	What it is
`url`	string	Yes	Retailer website URL

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`conditions`	array	Always (present in every successful answer)
`free_returns`	boolean	Always (present in every successful answer)
`refund_method`	string	Always (present in every successful answer)
`return_window_days`	number	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "return-policy-extract",
    "inputs": {
      "url": "https://www.amazon.com/gp/help/customer/display.html?nodeId=GKM69DUUYKQWKBER"
    },
    "max_price_cents": 20
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "return-policy-extract",
    "inputs": {
      "url": "https://www.amazon.com/gp/help/customer/display.html?nodeId=GKM69DUUYKQWKBER"
    },
    "max_price_cents": 20
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "return-policy-extract",
  inputs: {
    "url": "https://www.amazon.com/gp/help/customer/display.html?nodeId=GKM69DUUYKQWKBER"
  },
  max_price_cents: 20,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="return-policy-extract",
    inputs={
        "url": "https://www.amazon.com/gp/help/customer/display.html?nodeId=GKM69DUUYKQWKBER",
    },
    max_price_cents=20,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/return-policy-extract?url=https%3A%2F%2Fwww.amazon.com%2Fgp%2Fhelp%2Fcustomer%2Fdisplay.html%3FnodeId%3DGKM69DUUYKQWKBER'

Limitations

Complex conditions and exceptions can be simplified
Complex conditional policies and product-specific exceptions may be simplified during extraction.
What to do instead: Verify extracted terms against the retailer's full return policy page for product-category-specific conditions
Output size cap per call
Structured output is limited to about 2000 output tokens per call; requests exceeding this limit are refused rather than returned truncated. Requests with large results can exceed this limit, and repeating the same request does not help.
What to do instead: Read the retailer’s full return policy directly for conditions that exceed the output limit.