Quick start

1. Inspect the public contract

No authentication is needed to inspect the service:

curl https://test.x402labs.sh/v1/pricing
curl https://test.x402labs.sh/openapi.json

Pricing is dynamic. Read /v1/pricing before enforcing a maximum payment in your client.

2. Send the request

An unsigned request demonstrates the normal HTTP negotiation:

curl -i https://test.x402labs.sh/v1/scraping/scrape \
  -H 'content-type: application/json' \
  --data '{"url":"https://example.com","formats":["markdown"],"onlyMainContent":true}'

When payments are enabled, the API answers with 402 Payment Required and a machine-readable payment challenge. A compatible x402 client signs that challenge and repeats the request.

3. Use an x402 client

Configure your wallet in the client runtime, never in browser code or committed configuration. The client performs the challenge, payment, and retry sequence while your application handles the final JSON response.

const response = await paidFetch('https://test.x402labs.sh/v1/scraping/scrape', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    url: 'https://example.com',
    formats: ['markdown'],
    onlyMainContent: true,
  }),
});

const result = await response.json();

The exact wrapper API depends on your x402 client version. Consult that client's documentation for wallet construction and network support.

Next steps

Read x402 payments for the protocol flow or scraping to choose the right endpoint.