Cloudinary is a cloud-based service that provides comprehensive solutions for managing digital media assets, including images and videos, for websites and mobile applications. The platform exposes REST APIs for uploading and transforming media, administering assets and product environments, provisioning users and accounts, and configuring granular permissions. APIs use Basic Authentication with API key and secret over HTTPS.
Cloudinary publishes 9 API contracts indexed on the APIs.io network, including Notifications and Webhooks, Backup API, Transformation API, and 6 more. Tagged areas include Asset Management, Digital Asset Management, Image Processing, Image Transformation, and Media.
The Cloudinary catalog on APIs.io includes 1 event-driven AsyncAPI specification and 2 Spectral governance rulesets.
Cloudinary’s developer surface includes authentication, developer portal, documentation, signup flow, pricing, GitHub presence, privacy policy, and 11 more developer resources.
52.4/100developing▬ flatAgent45/100agent readyFront door AI6/6
dominant
Heartbeat100/100
alive
saas
Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/cloudinary/"><img src="https://apis.io/badge/cloudinary/card.svg" alt="Cloudinary on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Request/Response Examples+7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Documented Reversibility+6 pts — a reversal operation in the contract, graded up when a window is documented too
Agent Skills+5 pts — skills artifact present, graded by who authored it
4 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
The Provisioning API enables enterprise account-level management of product environments (sub-accounts), users, user groups, and API keys. Authentication uses provisioning API k...
The Permissions API assigns granular permissions to principals (users, groups, API keys) by roles or directly. Supports folder-scoped, asset- scoped, and product-environment-sco...
The Transformation URL API delivers and transforms images and videos by composing parameters into the delivery URL path (/{cloud_name}/{resource_type}/{type}/{transformations}/{...
AsyncAPI description of Cloudinary's outbound notification (webhook) surface. Cloudinary delivers event notifications by issuing HTTP POST requests with a JSON body to a notific...
aid: cloudinary
url: https://raw.githubusercontent.com/api-evangelist/cloudinary/refs/heads/main/apis.yml
name: Cloudinary
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
created: '2024-11-13'
modified: '2026-05-30'
type: Index
access: 3rd-Party
position: Consuming
specificationVersion: '0.23'
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/cloudinary.png
kind: company
tags:
- Asset Management
- Digital Asset Management
- Image Processing
- Image Transformation
- Media
- Software-as-a-Service
- Video Processing
tags_raw:
- Asset Management
- Digital Asset Management
- Image Processing
- Image Transformation
- Media
- SaaS
- Video Processing
description: Cloudinary is a cloud-based service that provides comprehensive solutions for managing digital media assets,
including images and videos, for websites and mobile applications. The platform exposes REST APIs for uploading and transforming
media, administering assets and product environments, provisioning users and accounts, and configuring granular permissions.
APIs use Basic Authentication with API key and secret over HTTPS.
apis:
- aid: cloudinary:admin
name: Cloudinary Admin API
tags:
- Administration
- Asset Management
- Folders
- Metadata
- Webhook
tags_raw:
- Administration
- Asset Management
- Folders
- Metadata
- Webhooks
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
baseURL: https://api.cloudinary.com/v1_1
humanURL: https://cloudinary.com/documentation/admin_api
properties:
- url: https://cloudinary.com/documentation/admin_api
type: Documentation
description: The Admin API supports bulk asset management (search, retrieval, update, delete, restore), and CRUD management
of folders, metadata fields, metadata rules, upload presets, transformations, streaming profiles, webhooks, mappings and
product environment configuration. Authentication uses HTTP Basic Auth with API key and secret. EU and AP regional endpoints
are available for enterprise customers (api-eu.cloudinary.com, api-ap.cloudinary.com).
- aid: cloudinary:search
name: Cloudinary Search API
tags:
- Asset Discovery
- Search
- Visual Search
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
baseURL: https://api.cloudinary.com/v1_1
humanURL: https://cloudinary.com/documentation/search_api
properties:
- url: https://cloudinary.com/documentation/search_api
type: Documentation
description: The Search API exposes Lucene-style query expressions across asset metadata, tags, contextual metadata, structured
metadata, and AI-derived tags. Supports sorting, aggregation, pagination via cursors, and saved searches. Visual search
and similarity search use perceptual hashes and embeddings to find visually similar assets.
- aid: cloudinary:provisioning
name: Cloudinary Provisioning API
tags:
- Account Management
- APIKeys
- Provisioning
- User
tags_raw:
- Account Management
- API Keys
- Provisioning
- Users
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
baseURL: https://api.cloudinary.com/v1_1/provisioning
humanURL: https://cloudinary.com/documentation/provisioning_api
properties:
- url: https://cloudinary.com/documentation/provisioning_api
type: Documentation
description: The Provisioning API enables enterprise account-level management of product environments (sub-accounts), users,
user groups, and API keys. Authentication uses provisioning API key and secret. Useful for onboarding teams, rotating
credentials, and automating environment lifecycle in multi-tenant deployments.
- aid: cloudinary:permissions
name: Cloudinary Permissions API
tags:
- Access Control
- Permissions
- RBAC
- Roles
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
baseURL: https://api.cloudinary.com/v1_1
humanURL: https://cloudinary.com/documentation/permissions_api
properties:
- url: https://cloudinary.com/documentation/permissions_api
type: Documentation
description: The Permissions API assigns granular permissions to principals (users, groups, API keys) by roles or directly.
Supports folder-scoped, asset- scoped, and product-environment-scoped permission grants and listing.
- aid: cloudinary:transformations
name: Cloudinary Transformation URL API
tags:
- Delivery
- Image Transformation
- URL API
- Video Transformation
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
baseURL: https://res.cloudinary.com
humanURL: https://cloudinary.com/documentation/transformation_reference
properties:
- url: https://cloudinary.com/documentation/transformation_reference
type: Documentation
description: The Transformation URL API delivers and transforms images and videos by composing parameters into the delivery
URL path (/{cloud_name}/{resource_type}/{type}/{transformations}/{public_id}). Supports resizing, cropping, color and
effect transformations, format conversion, watermarks, overlays, AI-driven content-aware operations, and conditional transformations.
- aid: cloudinary:notifications
name: Cloudinary Notifications and Webhooks
tags:
- Event
- Notification
- Webhook
tags_raw:
- Events
- Notifications
- Webhooks
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
humanURL: https://cloudinary.com/documentation/notifications
properties:
- url: https://cloudinary.com/documentation/notifications
type: Documentation
- url: asyncapi/cloudinary-notifications-asyncapi.yml
type: AsyncAPI
description: Cloudinary fires HTTP webhook notifications for upload completion, eager transformation completion, AI moderation
outcomes, asset deletion, and backup events. Notifications include signatures for verification and can target multiple
endpoints per product environment.
- aid: cloudinary:cloudinary-backup-api
name: Cloudinary Backup API
description: Backup retrieval operations.
humanURL: https://cloudinary.com/documentation/image_upload_api_reference
baseURL: https://api.cloudinary.com/v1_1
tags:
- Backup
properties:
- type: OpenAPI
url: openapi/cloudinary-backup-api-openapi.yml
- type: Documentation
url: https://cloudinary.com/documentation/image_upload_api_reference
- type: GettingStarted
url: https://cloudinary.com/documentation/upload_images
- aid: cloudinary:cloudinary-transformation-api
name: Cloudinary Transformation API
description: Apply transformations to existing assets.
humanURL: https://cloudinary.com/documentation/image_upload_api_reference
baseURL: https://api.cloudinary.com/v1_1
tags:
- Transformation
properties:
- type: OpenAPI
url: openapi/cloudinary-transformation-api-openapi.yml
- type: Documentation
url: https://cloudinary.com/documentation/image_upload_api_reference
- type: GettingStarted
url: https://cloudinary.com/documentation/upload_images
- aid: cloudinary:cloudinary-upload-api
name: Cloudinary Upload API
description: Asset upload and management.
humanURL: https://cloudinary.com/documentation/image_upload_api_reference
baseURL: https://api.cloudinary.com/v1_1
tags:
- Upload
properties:
- type: OpenAPI
url: openapi/cloudinary-upload-api-openapi.yml
- type: Documentation
url: https://cloudinary.com/documentation/image_upload_api_reference
- type: GettingStarted
url: https://cloudinary.com/documentation/upload_images
common:
- type: Plans
url: plans/cloudinary-plans-pricing.yml
- type: RateLimits
url: rate-limits/cloudinary-rate-limits.yml
- type: FinOps
url: finops/cloudinary-finops.yml
- type: CapabilityMap
url: capabilities/cloudinary-capability-edges.yml
name: Cloudinary Business Capability Map
- type: AgenticAccess
url: agentic-access/cloudinary-agentic-access.yml
- type: DomainSecurity
url: security/cloudinary-domain-security.yml
- type: Authentication
url: authentication/cloudinary-authentication.yml
- type: LinkedIn
url: https://www.linkedin.com/company/cloudinary
- type: Website
url: https://cloudinary.com/
- type: Portal
url: https://console.cloudinary.com/
- type: Documentation
url: https://cloudinary.com/documentation
- type: Signup
url: https://cloudinary.com/users/register_free
- type: Pricing
url: https://cloudinary.com/pricing
- type: StatusPage
url: https://status.cloudinary.com/
- type: GitHub
url: https://github.com/cloudinary
- type: TermsOfService
url: https://cloudinary.com/tos
- type: Privacy
url: https://cloudinary.com/privacy
- type: Features
data:
- 'Free: 25 monthly credits with all core features'
- 'Plus at $99/mo: 225 credits, S3 backup, auto-tagging'
- 'Advanced at $249/mo: 600 credits, custom domain, SSL'
- 'Enterprise: custom credits, multi-CDN, dedicated CSM'
- Credits = sum of transformations + storage + bandwidth
- Image and video transformation API
- URL-based on-the-fly transformations
- Video transcoding and adaptive bitrate streaming
- Upload API with auto-tagging
- 'Admin API: 500 req/hr Free, 2K req/hr Paid'
- Bulk delete up to 1,000 resources/request
- AI-powered transformations (background removal, generative fill)
- Auto-format and auto-quality for delivery
- Programmable Media SDKs (JS, mobile, server)
- Digital Asset Management (DAM) with workflows
- Multi-CDN delivery (Akamai + Fastly + others on Enterprise)
sources:
- https://cloudinary.com/pricing
updated: '2026-05-04'
- type: Integrations
url: https://cloudinary.com/integrations
- type: LlmsText
url: https://cloudinary.com/llms.txt
integrations:
- name: AWS
- name: Shopify
- name: Contentful
- name: Syndigo
- name: WordPress
- name: ContentSquare
- name: Actindo
- name: Adobe Commerce
- name: Adobe Creative Cloud Connector
- name: Adobe Workfront
- name: Agility
- name: Akeneo
- name: AltText.ai
- name: Bluestone PIM
- name: 'Braze + Cloudinary: Instant, At-Scale Personalization'
- name: Builder.io
- name: ButterCMS
- name: Chioro (eCube)
- name: CloudCannon
- name: CloudEagle.ai
- name: Commercetools
- name: Conscia
- name: Contentstack
- name: Creative Force
- name: Digital Wave
- name: Dropbox
- name: Drupal
- name: FADEL
- name: Figma
- name: Front-Commerce
- name: Gemini
- name: Gettyimages
- name: Google chrome media library extension
- name: Google Cloud CDN
- name: Google Cloud Storage
- name: Google Translate
- name: Google Workspace
- name: Hootsuite
- name: HubSpot
- name: Hygraph (Graphcms)
- name: Intuiface
- name: iStock
- name: Kontent.ai
- name: LiveStory
- name: Magnolia
- name: Mailchimp (Intuit)
- name: Marketo
- name: Microsoft Office Microsoft 365
- name: Mobius Labs
- name: monday.com
- name: Movidmo
- name: Netlify
- name: Netlify Create (Stackbit)
- name: OpenAI
- name: OpenText for Teamsite (by Klish)
- name: Progress Sitefinity
- name: SalesForce Commerce Cloud
- name: SalesForce Marketing Cloud
- name: SalesForce Page Designer
- name: Sanity
- name: SAP Commerce Extension
- name: Shutterstock
- name: Slack
- name: Smint.io
- name: STEP - Stibo Systems Platform
- name: Storyblok
- name: Uniform
- name: Unsplash
- name: Wrike
- name: Zapier
- name: Ziflow
- url: https://cloudinary.com/blog/feed
type: Blog
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
Cloudinary API — frequently asked questions
Does Cloudinary have an API?
Yes. APIs.io lists 9 APIs from Cloudinary, including Cloudinary Admin API, Cloudinary Search API and Cloudinary Provisioning API, and 6 more.
Is there an OpenAPI specification for the Cloudinary API?
Yes. APIs.io indexes 3 OpenAPI specifications for Cloudinary, each linked for download from this page.
How do I authenticate with the Cloudinary API?
Cloudinary documents its authentication (http · 1 scheme). The details are profiled on APIs.io as Cloudinary Authentication.
How much does the Cloudinary API cost?
Cloudinary publishes its prices; its Free plan is $0 as of 2026-10-28. APIs.io lists 8 pricing plans for Cloudinary, with each plan's price, limits and inclusions under Pricing on this page.
Does Cloudinary have an MCP server?
Yes. APIs.io lists 1 MCP server for Cloudinary: Remote MCP server at asset-management.mcp.cloudinary.com over HTTP.
Is the Cloudinary API ready for AI agents?
Cloudinary has a Kin Score of 52.4 out of 100 (developing) and an Agent Readiness score of 45.0 (agent-ready), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: