{"id":23053,"library":"criteo-api-retailmedia-sdk","title":"Criteo Retail Media API SDK","description":"Official Python SDK for the Criteo Retail Media API. Current version 2026.1.0.260427, with monthly releases aligned to the API version.","status":"active","version":"2026.1.0.260427","language":"python","source_language":"en","source_url":"https://github.com/criteo/criteo-api-python-sdk","tags":["criteo","retail-media","advertising","api-sdk"],"install":[{"cmd":"pip install criteo-api-retailmedia-sdk","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"ApiClient is a top-level export, not under api module.","wrong":"from criteo_api_retailmedia_sdk.api import ApiClient","symbol":"ApiClient","correct":"from criteo_api_retailmedia_sdk import ApiClient"}],"quickstart":{"code":"import os\nfrom criteo_api_retailmedia_sdk import ApiClient\nfrom criteo_api_retailmedia_sdk.api import AccountApi\n\nclient = ApiClient(\n    client_id=os.environ.get('CRITEO_CLIENT_ID', ''),\n    client_secret=os.environ.get('CRITEO_CLIENT_SECRET', ''),\n    environment='production'\n)\naccounts_api = AccountApi(client)\ntry:\n    response = accounts_api.get_accounts()\n    print(response)\nexcept Exception as e:\n    print(f\"Error: {e}\")","lang":"python","description":"Initialize the SDK client with credentials and call an API endpoint."},"warnings":[{"fix":"Verify the desired API version from Criteo docs and install the matching SDK version.","message":"The SDK release version (e.g., 2026.1.0.260427) must exactly match the target API version. Using a mismatched SDK can cause serialization/deserialization errors.","severity":"breaking","affected_versions":"all"},{"fix":"Set both environment variables and ensure the environment parameter matches your contract.","message":"ApiClient requires both client_id and client_secret. Passing only one or using wrong environment (e.g., 'staging' vs 'production') leads to authentication failures.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'from criteo_api_retailmedia_sdk import ApiClient'.","message":"The 'retail-media' package was renamed to 'criteo-api-retailmedia-sdk'. Old imports from 'criteo_marketing' or 'criteo_api_retailmedia' are invalid.","severity":"deprecated","affected_versions":">=2024.10.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install criteo-api-retailmedia-sdk' and use the correct import path.","cause":"Installed the wrong package or didn't install at all. The deprecated package 'criteo-api-retailmedia' or 'criteo' is different.","error":"ModuleNotFoundError: No module named 'criteo_api_retailmedia_sdk'"},{"fix":"Update to the latest SDK and import 'from criteo_api_retailmedia_sdk import ApiClient'.","cause":"Trying to import ApiClient from the deprecated location (e.g., criteo_api_retailmedia_sdk.api_client) or running an old SDK version.","error":"AttributeError: module 'criteo_api_retailmedia_sdk' has no attribute 'ApiClient'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}