release: 0.55.0

[stainless-app]

Automated Release PR

0.55.0 (2026-07-30)

Full Changelog: v0.54.0...v0.55.0

Features

• api: api update (2c7ba50)
• api: api update (6b26be9)
• api: api update (bdcfe8e)
• api: api update (3776adc)
• api: shopping v2 endpoints (c1b09be)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

Note

Release v0.55.0 with Shopping v2 endpoints and citation categories support

• Replaces all Shopping v1 report methods on ShoppingResource with v2 equivalents: brands, merchants, products, trigger_rate, and streaming variants (stream_brands, stream_merchants, stream_products, stream_trigger_rate) posting to /v2/reports/shopping/* routes.
• Streaming methods return Stream[ShoppingStream*Response] / AsyncStream[ShoppingStream*Response] via SSE (Accept: text/event-stream), replacing prior non-streaming responses.
• Adds CategoriesResource.get_citation_categories (sync and async) that fetches citation categories for a given category_id via GET /v1/org/categories/{category_id}/citation-categories.
• Adds citation_details as an opt-in field to prompt answers v2 params and responses, with new DataCitationDetail / AnswerRowCitationDetail models.
• Risk: all prior v1 Shopping method names (all_items_with_merchants, executions, item_visibility, merchant_by_items, etc.) are removed and replaced with the new v2 names, which is a breaking change for existing callers.

^{Macroscope summarized 29df155.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/profound-python/c1b09be0bbcda1b4fbd243ff8aa834bc86492027/profound-0.54.0-py3-none-any.whl'

Expires at: Sat, 29 Aug 2026 15:06:17 GMT
Updated at: Thu, 30 Jul 2026 15:06:17 GMT

[stainless-app]

🤖 Release is at https://github.com/cooper-square-technologies/profound-python-sdk/releases/tag/v0.55.0 🌻