# Seller schema (/docs/schema/seller)

The unified SocialCrawl seller offer schema. Every field, its type, per-platform availability, and a machine-readable JSON Schema, generated from the canonical Zod source.

Every SocialCrawl endpoint that returns a seller offer gives you this exact shape, whatever the source platform. Write your parser once and the same code reads seller data from every platform below. That is the unified schema: one contract instead of a dozen raw upstream formats.

## Field reference

| Field | Type | Nullable | Description |
| ----- | ---- | -------- | ----------- |
| `id` | `string` | Yes |  |
| `name` | `string` | Yes | Seller name |
| `domain` | `string` | Yes |  |
| `url` | `string` | Yes |  |
| `price.base` | `integer` | Yes |  |
| `price.tax` | `integer` | Yes |  |
| `price.shipping` | `integer` | Yes |  |
| `price.total` | `integer` | Yes |  |
| `price.currency` | `string` | Yes |  |
| `rating.average` | `integer` | Yes |  |
| `rating.count` | `integer` | Yes |  |
| `condition` | `string` | Yes | Item condition (e.g. "New", "Refurbished - Excellent") |
| `availability` | `string` | Yes |  |
| `annotation` | `string` | Yes |  |

## Platform availability

5 platforms return the `Seller` shape. **yes** means the platform populates the field (the value may still be null); a blank means the platform never provides it, so it is always null.

<div className="overflow-x-auto">

| Platform | `annotation` | `availability` | `condition` | `domain` | `id` | `price.base` | `price.currency` | `price.shipping` | `price.total` | `rating.average` | `rating.count` | `price.tax` |
| -------- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Amazon | yes |  | yes | yes | yes | yes | yes |  | yes | yes | yes |  |
| Google Shopping | yes | yes | yes | yes |  | yes | yes | yes | yes | yes | yes | yes |
| Gumtree |  |  |  |  |  |  |  |  |  | yes | yes |  |
| Klarna |  |  |  |  | yes |  |  |  |  |  |  |  |
| Walmart | yes | yes | yes |  | yes | yes | yes | yes | yes |  |  |  |

</div>

## Machine-readable schema

Validate responses programmatically against the JSON Schema (2020-12):

[`/schemas/seller.json`](/schemas/seller.json)

Point a validator (Ajv, `jsonschema`, or your framework's) at that URL, or hand it to an agent so it can check the shape without a live call.

## Returned by

Endpoints with the `Seller` / `SellerList` archetype return this shape:

[Amazon](/platforms/amazon) · [Google Shopping](/platforms/google_shopping) · [Gumtree](/platforms/gumtree) · [Klarna](/platforms/klarna) · [Walmart](/platforms/walmart)

See how the same fields map to each platform's raw upstream names in the [cross-platform field equivalence table](/docs/schema/field-equivalence.md).