OpenClipart APIopenclipart.org ↗
Access 185,000+ free clipart items from OpenClipart. Search by keyword, browse tags, retrieve artist profiles, and fetch download URLs via a clean REST API.
What is the OpenClipart API?
The OpenClipart API covers 7 endpoints for searching, browsing, and retrieving data from a library of 185,000+ free SVG clipart items created by 8,200+ artists. The search_clipart endpoint accepts a keyword query and returns paginated results with thumbnails and detail URLs. You can also retrieve full item metadata — including tags, love count, upload date, and download URLs — through get_clipart_detail, or pull an artist's contribution stats and recent uploads via get_artist_profile.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b3871a53-4087-4738-bba4-49e32edf63c0/get_engagement_stats' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace openclipart-org-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Openclipart SDK — search, browse, and explore free clipart."""
from parse_apis.openclipart_api import Openclipart, ResourceNotFound
client = Openclipart()
# Search for clipart by keyword, capped at 5 total items.
for item in client.cliparts.search(query="cat", limit=5):
print(item.title, item.detail_url)
# Drill into the first result for full details.
summary = client.cliparts.search(query="flower", limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.author, detail.love_count)
print("Tags:", detail.tags[:5])
# Browse by tag — paginated, limited to 3 items.
for item in client.cliparts.by_tag(tag="animal", limit=3):
print(item.title, item.slug)
# Fetch an artist profile by username.
artist = client.artists.get(username="j4p4n")
print(artist.username, artist.total_clipart, artist.total_loves_received)
# Handle a not-found error gracefully.
try:
client.cliparts.get(id="9999999")
except ResourceNotFound as exc:
print(f"Not found: {exc}")
# Get a random clipart item.
random_clip = client.cliparts.random()
print(random_clip.title, random_clip.author, random_clip.upload_date)
print("exercised: cliparts.search / details / by_tag / artists.get / cliparts.get / cliparts.random")
Extract site-wide statistics and recent artist activity from the homepage and Atom feed. Returns total clipart count, total artist count, daily activity metrics, and the latest uploads from the feed. No parameters required; useful for monitoring site health and activity levels.
No input parameters required.
{
"type": "object",
"fields": {
"site_stats": "object containing total_clipart, total_artists, clipart_today, artists_today integer counts",
"recent_activity_proxy": "object containing sample_size integer, unique_artists_in_latest_feed integer, and latest_uploads array of objects with id, title, author, updated"
},
"sample": {
"data": {
"site_stats": {
"artists_today": 6,
"clipart_today": 17,
"total_artists": 8242,
"total_clipart": 185436
},
"recent_activity_proxy": {
"sample_size": 32,
"latest_uploads": [
{
"id": "tag:openclipart.org,2026-06-11:detail/355973",
"title": "Diabolical hands",
"author": "rferran",
"updated": "2026-06-11T08:33:11Z"
}
],
"unique_artists_in_latest_feed": 6
}
},
"status": "success"
}
}About the OpenClipart API
Searching and Browsing Clipart
The search_clipart endpoint matches a required query string against tags and returns paginated item summaries. Each item in the items array includes an id, slug, title, thumbnail, and detail_url. The total_results and total_pages fields let you build pagination logic. For exact-match tag browsing, get_clipart_by_tag accepts a tag parameter and returns an identical response structure filtered to items carrying that tag.
Item Details and Downloads
get_clipart_detail accepts a numeric id string — obtainable from any search or tag result — and returns a full record including title, author, upload_date, description, tags array, love_count, and a downloads object that maps format keys (such as svg) to direct download URLs. The optional slug parameter can be supplied for URL construction but is not required for lookup. get_random_clipart returns the same full-detail shape for a randomly selected item, useful for discovery or sampling.
Artist Profiles and Site Statistics
get_artist_profile takes a username and returns member_since year, total_clipart uploaded, total_loves_received, and a latest_clipart array of recent uploads with thumbnails. get_engagement_stats pulls site-wide counts — total_clipart, total_artists, clipart_today, artists_today — plus a recent_activity_proxy object with a latest_uploads array and a count of unique_artists_in_latest_feed.
API Version Endpoint
get_api_version queries the official OpenClipart.org API version endpoint and returns a data object containing the name and version string, along with a status code and success boolean. This is useful for health checks or confirming the upstream service is responsive.
The OpenClipart API is a managed, monitored endpoint for openclipart.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when openclipart.org changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official openclipart.org API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a clipart search UI that queries
search_clipartby keyword and displays thumbnail grids with direct SVG download links. - Generate nightly reports on site growth using
get_engagement_statsfields liketotal_clipart,total_artists, andclipart_today. - Populate a tag-based clipart browser using
get_clipart_by_tagwith pagination acrosstotal_pages. - Build artist spotlight pages using
get_artist_profileto displaytotal_loves_received,member_since, and recent uploads. - Implement a 'clipart of the day' widget using
get_random_clipartto fetch a full detail record on each request. - Index clipart metadata for a full-text search engine by walking pages of
search_clipartresults and expanding each viaget_clipart_detail. - Track which tags have the most items over time by recording
total_resultsfrom repeatedget_clipart_by_tagcalls.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OpenClipart have an official developer API?+
get_api_version endpoint in this API queries that service directly and returns the version string and status.What does `get_clipart_detail` return beyond what search results include?+
search_clipart and get_clipart_by_tag return summary fields: id, slug, title, thumbnail, and detail_url. get_clipart_detail expands this to include tags, author, upload_date, description, love_count, and the downloads object with format-keyed download URLs — including the direct SVG link.Can I retrieve a specific artist's full upload history or filter by date?+
get_artist_profile returns total_clipart count and a latest_clipart array of recent uploads, but it does not paginate through an artist's full upload history or accept date range filters. You can fork this API on Parse and revise it to add a paginated artist-uploads endpoint.Does the API return clipart collections or sets grouped by theme?+
search_clipart and by individual tag via get_clipart_by_tag, but there is no endpoint for named collections or curated sets. You can fork this API on Parse and revise it to add a collections endpoint if OpenClipart exposes that grouping.How does pagination work across search and tag endpoints?+
search_clipart and get_clipart_by_tag accept an optional page integer. The response includes current_page, total_pages, and total_results, so you can iterate through all pages programmatically by incrementing page until it reaches total_pages.