Catalog

Search the catalog

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token presented through Authorization: Bearer $GODADDY_PAT. The PAT must include the scope documented for the operation.

In: header

Header Parameters

Request-Id*string

For tracing the request across network layers and components.

Formatuuid

Request Body

application/json

query?string

Free-text search query.

context?

Provisional buyer signals for relevance and localization—not authoritative data. Businesses SHOULD use these values when verified inputs (e.g., shipping address) are absent, and MAY ignore or down-rank them if inconsistent with higher-confidence signals (authenticated account, risk detection) or regulatory constraints (export controls). Eligibility and policy enforcement MUST occur at checkout time using binding transaction data. Context SHOULD be non-identifying and can be disclosed progressively—coarse signals early, finer resolution as the session progresses. Higher-resolution data (shipping address, billing address) supersedes context.

signals?

Environment data provided by the platform to support authorization and abuse prevention. Values MUST NOT be buyer-asserted claims — platforms provide signals based on direct observation or independently verifiable third-party attestations. All signal keys MUST use reverse-domain naming to ensure provenance and prevent collisions when multiple extensions contribute to the shared namespace.

attribution?

Platform-emitted referral and conversion-event context — campaign identifiers, click IDs, source/medium markers, etc. The same parameters platforms communicate via URL query parameters in browser-based flows.

filters?

Filter criteria to narrow search results. All specified filters combine with AND logic.

pagination?

Pagination parameters for requests.

domains?array<>

GoDaddy negotiated domain-discovery candidates. This is separate from free-text query.

Items1 <= items <= 100

Response Body

`application/json`

curl -X POST "https://example.com/catalog/search" \  -H "Request-Id: 6ba7b810-9dad-41d1-80b4-00c04fd430c8" \  -H "Content-Type: application/json" \  -d '{    "context": {      "address_country": "US",      "currency": "USD",      "language": "en"    },    "pagination": {      "limit": 20    }  }'

{  "ucp": {    "version": "2026-04-08",    "capabilities": {      "dev.ucp.shopping.catalog.search": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.input": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_action": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_offer": [        {          "version": "2026-04-08"        }      ]    }  },  "products": [    {      "id": "hosting-economyapi",      "title": "Web Hosting Economy — Monthly",      "description": {        "plain": "Web Hosting on the Economy plan, which also includes Node.js Hosting for deploying your app. Billed monthly with automatic renewal."      },      "categories": [        {          "value": "webHosting"        }      ],      "price_range": {        "min": {          "amount": 799,          "currency": "USD"        },        "max": {          "amount": 799,          "currency": "USD"        }      },      "variants": [        {          "id": "hosting-economyapi:1mo",          "title": "Web Hosting Economy — 1 Month",          "description": {            "plain": "Web Hosting Economy, 1-month term."          },          "price": {            "amount": 799,            "currency": "USD"          },          "list_price": {            "amount": 799,            "currency": "USD"          },          "availability": {            "available": true          },          "options": [            {              "name": "Term",              "id": "1mo",              "label": "1 Month"            }          ]        }      ]    },    {      "id": "hosting-deluxeapi",      "title": "Web Hosting Deluxe — Monthly",      "description": {        "plain": "Web Hosting on the Deluxe plan, which also includes Node.js Hosting for deploying your app. Billed monthly with automatic renewal."      },      "categories": [        {          "value": "webHosting"        }      ],      "price_range": {        "min": {          "amount": 1099,          "currency": "USD"        },        "max": {          "amount": 1099,          "currency": "USD"        }      },      "variants": [        {          "id": "hosting-deluxeapi:1mo",          "title": "Web Hosting Deluxe — 1 Month",          "description": {            "plain": "Web Hosting Deluxe, 1-month term."          },          "price": {            "amount": 1099,            "currency": "USD"          },          "list_price": {            "amount": 1099,            "currency": "USD"          },          "availability": {            "available": true          },          "options": [            {              "name": "Term",              "id": "1mo",              "label": "1 Month"            }          ]        }      ]    },    {      "id": "hosting-ultimateapi",      "title": "Web Hosting Ultimate — Monthly",      "description": {        "plain": "Web Hosting on the Ultimate plan, which also includes Node.js Hosting for deploying your app. Billed monthly with automatic renewal."      },      "categories": [        {          "value": "webHosting"        }      ],      "price_range": {        "min": {          "amount": 1599,          "currency": "USD"        },        "max": {          "amount": 1599,          "currency": "USD"        }      },      "variants": [        {          "id": "hosting-ultimateapi:1mo",          "title": "Web Hosting Ultimate — 1 Month",          "description": {            "plain": "Web Hosting Ultimate, 1-month term."          },          "price": {            "amount": 1599,            "currency": "USD"          },          "list_price": {            "amount": 1599,            "currency": "USD"          },          "availability": {            "available": true          },          "options": [            {              "name": "Term",              "id": "1mo",              "label": "1 Month"            }          ]        }      ]    }  ],  "pagination": {    "has_next_page": false,    "total_count": 3  }}

Look up products by ID

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token presented through Authorization: Bearer $GODADDY_PAT. The PAT must include the scope documented for the operation.

In: header

Header Parameters

Request-Id*string

For tracing the request across network layers and components.

Formatuuid

Request Body

application/json

Request body for catalog lookup.

ids*array<string>

Identifiers to lookup. Implementations MUST support product ID and variant ID; MAY support secondary identifiers (SKU, handle, etc.).

Items1 <= items

filters?

Filter criteria to narrow returned products and variants. All specified filters combine with AND logic.

context?

signals?

attribution?

Response Body

`application/json`

curl -X POST "https://example.com/catalog/lookup" \  -H "Request-Id: 6ba7b810-9dad-41d1-80b4-00c04fd430c8" \  -H "Content-Type: application/json" \  -d '{    "ids": [      "hosting-deluxeapi:1mo"    ],    "context": {      "currency": "USD"    }  }'

{  "ucp": {    "version": "2026-04-08",    "capabilities": {      "dev.ucp.shopping.catalog.lookup": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.input": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_action": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_offer": [        {          "version": "2026-04-08"        }      ]    }  },  "products": [    {      "id": "hosting-deluxeapi",      "title": "Web Hosting Deluxe — Monthly",      "description": {        "plain": "Web Hosting on the Deluxe plan, which also includes Node.js Hosting for deploying your app. Billed monthly with automatic renewal."      },      "categories": [        {          "value": "webHosting"        }      ],      "price_range": {        "min": {          "amount": 1099,          "currency": "USD"        },        "max": {          "amount": 1099,          "currency": "USD"        }      },      "variants": [        {          "id": "hosting-deluxeapi:1mo",          "title": "Web Hosting Deluxe — 1 Month",          "description": {            "plain": "Web Hosting Deluxe, 1-month term."          },          "price": {            "amount": 1099,            "currency": "USD"          },          "list_price": {            "amount": 1099,            "currency": "USD"          },          "availability": {            "available": true          },          "options": [            {              "name": "Term",              "id": "1mo",              "label": "1 Month"            }          ],          "inputs": [            {              "id": "hosting-deluxeapi:1mo",              "match": "exact"            }          ]        }      ]    }  ]}

Get product details

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token presented through Authorization: Bearer $GODADDY_PAT. The PAT must include the scope documented for the operation.

In: header

Header Parameters

Request-Id*string

For tracing the request across network layers and components.

Formatuuid

Request Body

application/json

Request body for single-product retrieval. Supports interactive variant narrowing via selected and preferences.

id*string

Product or variant identifier. Implementations MUST support product ID and variant ID.

selected?array<>

Partial or full option selections for interactive variant narrowing. When provided, response option values include availability signals (available, exists) relative to these selections.

preferences?array<string>

Option names in relaxation priority order. When no exact variant matches all selections, the server drops options from the end of this list first. E.g., ['Color', 'Size'] keeps Color and relaxes Size.

filters?

Filter criteria to narrow returned variants. All specified filters combine with AND logic.

context?

signals?

attribution?

Response Body

`application/json`

curl -X POST "https://example.com/catalog/product" \  -H "Request-Id: 6ba7b810-9dad-41d1-80b4-00c04fd430c8" \  -H "Content-Type: application/json" \  -d '{    "id": "hosting-deluxeapi"  }'

{  "ucp": {    "version": "2026-04-08",    "capabilities": {      "dev.ucp.shopping.catalog.lookup": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.input": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_action": [        {          "version": "2026-04-08"        }      ],      "com.godaddy.shopping.catalog_offer": [        {          "version": "2026-04-08"        }      ]    }  },  "product": {    "id": "hosting-deluxeapi",    "title": "Web Hosting Deluxe — Monthly",    "description": {      "plain": "Web Hosting on the Deluxe plan, which also includes Node.js Hosting for deploying your app. Billed monthly with automatic renewal."    },    "categories": [      {        "value": "webHosting"      }    ],    "price_range": {      "min": {        "amount": 1099,        "currency": "USD"      },      "max": {        "amount": 1099,        "currency": "USD"      }    },    "variants": [      {        "id": "hosting-deluxeapi:1mo",        "title": "Web Hosting Deluxe — 1 Month",        "description": {          "plain": "Web Hosting Deluxe, 1-month term."        },        "price": {          "amount": 1099,          "currency": "USD"        },        "list_price": {          "amount": 1099,          "currency": "USD"        },        "availability": {          "available": true        },        "options": [          {            "name": "Term",            "id": "1mo",            "label": "1 Month"          }        ]      }    ]  }}

Last updated on

Catalog

200application/json

400application/json

401

403

404application/json

422application/json

429

200application/json

400application/json

401

403

404application/json

422application/json

429

200application/json

400application/json

401

403

404application/json

422application/json

429

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`