canonical: https://jentic.com/apis/marketplace.api.1worldsync.com/1worldsync

# Marketplace Api 1worldsync 1WorldSync Content1 API

Jentic publishes the only available OpenAPI specification for 1WorldSync Content1 API, keeping it validated and agent-ready. 1WorldSync Content1 provides retailer-grade product content sourced directly from brand owners through 1WorldSync's product information network. The two endpoints expose a product search at /products and a single-product detail lookup at /products/{itemReferenceId}. Typical responses include identifiers (GTIN, UPC), localised descriptions, attributes, marketing copy, and digital assets. The API is positioned for retailers, marketplaces, and product information management (PIM) systems that need authoritative manufacturer-supplied product content.

## For AI agents

Search and retrieve trusted brand-supplied product content from the 1WorldSync network through two endpoints - list products and fetch a single product by reference ID.

## Scope

Does not handle order processing, inventory levels, pricing, or storefront management - use for retrieving brand-supplied product content from the 1WorldSync network only.

## Capabilities

- Search the 1WorldSync product catalogue with /products including filters and pagination parameters
- Retrieve a single product's full content payload via /products/{itemReferenceId}
- Pull brand-supplied descriptions, attributes, marketing copy, and digital asset references for a product
- Resolve a GTIN, UPC, or internal item reference to authoritative manufacturer content
- Backfill a retailer PIM with manufacturer-grade content for newly onboarded SKUs
- Refresh stored content for a SKU when a brand owner updates the master record
- Validate a downstream catalogue against the 1WorldSync source of truth

## Use cases

### Retailer Catalogue Backfill

Retailers and marketplaces call /products on a schedule to pull batches of newly onboarded SKUs and /products/{itemReferenceId} for the full content payload of each one. The brand-supplied descriptions, attributes, and digital assets land directly in the retailer's PIM and replace lower-quality data scraped from supplier feeds. A first integration takes a few days including pagination and PIM mapping.

Example prompt: Page through /products filtered to a target brand, then call /products/{itemReferenceId} for each result and write the response to the retailer's PIM staging table.

### Product Detail Page Enrichment

E-commerce platforms call /products/{itemReferenceId} to enrich a product detail page with authoritative manufacturer copy, structured attributes, and digital assets. Because the content originates with the brand owner it improves discoverability and conversion versus scraped or supplier-supplied descriptions. Typical wiring is half a day behind a CMS template.

Example prompt: Call /products/{itemReferenceId} with the SKU's reference ID and return the localised description, marketing copy, and the first three image asset URLs.

### Marketplace Onboarding Validation

Marketplace onboarding pipelines call /products to confirm that a seller-supplied SKU exists in the 1WorldSync network and /products/{itemReferenceId} to compare the seller's submitted attributes against the brand owner's authoritative record. Discrepancies are flagged for the seller to correct before listing goes live, which reduces returns and listing-quality complaints.

Example prompt: Search /products for a candidate GTIN, fetch /products/{itemReferenceId} for the matching record, and return any attribute where the seller's submission differs from the master.

### Digital Asset Sync

Digital asset management (DAM) tools call /products/{itemReferenceId} to pull the brand owner's official image, video, and document links and mirror them into the retailer's CDN. This keeps creative assets aligned with the brand's latest packaging and marketing without manual asset uploads.

Example prompt: Call /products/{itemReferenceId} for a list of SKUs and return only the digital asset URLs grouped by asset type (image, video, document).

### AI Agent Catalogue Operations

An AI agent embedded in a retailer's catalogue operations team calls 1WorldSync Content1 through Jentic to look up master records, refresh stale content, and backfill new SKUs without bespoke client code. Jentic exposes both endpoints as typed tools with discoverable input schemas so the agent picks /products vs /products/{itemReferenceId} based on whether it is searching or fetching.

Example prompt: Search Jentic for 'fetch a 1WorldSync product record', load the schema for /products/{itemReferenceId}, and execute the call for the SKU's reference ID supplied by the user.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /products | Search the 1WorldSync product catalogue |
| GET | /products/{itemReferenceId} | Fetch a single product record |

## Key resources

- **Products** — Search and detail endpoints for the 1WorldSync product catalogue under /products

## Why Jentic

- **Setup:** Wiring 1WorldSync Content1 by hand means arranging the credential pattern from your 1WorldSync contract, learning the two /products endpoints, and parsing the product content yourself. Through Jentic you install once, import the 1WorldSync Content1 API from the API Directory, store the contract credential once, and your agent calls it.
- **Permission scoping:** The two Content1 endpoints are read-only product lookups, so scoping is by operation: you limit the agent to the operations it needs, such as searching products or fetching one by its item reference id, and leave out the other if you do not want it called. Every operation you allow is one you have chosen, so the agent stays inside that set.
- **Credential handling:** Your 1WorldSync credential is stored once, encrypted, by your own Jentic One instance and applied at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'fetch a 1WorldSync product record' or 'search 1WorldSync products', and Jentic returns the matching Content1 operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Shopify** — Shopify is the storefront and order layer that consumes the brand-grade product content sourced from 1WorldSync.
- **eBay** — eBay's listing APIs consume product content; 1WorldSync supplies the brand-supplied master record behind the listing.
- **Best Buy** — Best Buy's API exposes a single retailer's product catalogue; 1WorldSync exposes brand-supplied master content across many retailers.
- **Edamam Food and Recipe** — Edamam covers grocery and recipe metadata; 1WorldSync covers a far broader brand-supplied product catalogue.

## FAQ

### Why is there no official OpenAPI spec for 1WorldSync Content1 API?

1WorldSync does not publish an OpenAPI specification on its public marketing site. Jentic generates and maintains this spec so that AI agents and developers can call 1WorldSync Content1 API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the 1WorldSync Content1 API use?

The published spec does not declare a security scheme. In practice 1WorldSync issues per-customer credentials at contract signing and access is controlled at the network level; refer to your 1WorldSync onboarding pack for the exact credential pattern your account uses.

### Can I retrieve a single product's full content record?

Yes. GET /products/{itemReferenceId} returns the full content payload for one product including identifiers, attributes, localised descriptions, and digital asset references. Use GET /products to discover the item reference IDs first.

### What are the rate limits for the 1WorldSync Content1 API?

Rate limits are negotiated per customer contract rather than published in the spec. Production callers should batch search calls and cache /products/{itemReferenceId} responses for the typical content refresh interval agreed with 1WorldSync.

### How do I backfill a retailer PIM through Jentic?

Run `pip install jentic`, search for 'list 1WorldSync products' and 'fetch a 1WorldSync product record', and chain the two operations: page through GET /products and call GET /products/{itemReferenceId} for each hit. Jentic loads the input schema for each endpoint.

### Does 1WorldSync return localised product descriptions?

Yes. The /products/{itemReferenceId} response carries localised marketing copy and descriptions when the brand owner has supplied them, which is how retailers populate region-specific storefronts from a single source of truth.

### Can I limit what my agent is allowed to do with the 1WorldSync Content1 API?

Yes. Because you run Jentic One yourself, your own rules decide which of the two read-only Content1 operations your agent may call: searching the product catalogue with GET /products or fetching one record with GET /products/{itemReferenceId}. You can allow only the operation the agent needs and leave the other out, so the agent stays inside the set you have chosen. Your 1WorldSync credential is applied at execution time and never enters the agent's prompt or logs.