Vecteezy Scraper

Scrape Vecteezy's free stock marketplace — vectors, photos, videos, PSD templates, SVGs, PNGs, editable templates, motion graphics, and editorial photos/events. Search or browse by keyword/category, filter by license, orientation, sort order, and color, browse a contributor's full upload catalog, and look up rich asset details (including related keywords) from a direct URL. Every search/browse page on Vecteezy is fully server-rendered, so this actor runs on plain HTTP (no browser automation, no login, no proxy required) — it just needs a browser-realistic TLS handshake to get past Cloudflare's fingerprint check.

What this actor does

• Three modes: search (keyword search or category browsing — Vecteezy treats both the same way), assetDetail (lookup by direct asset URL, enriched with related keywords), and byAuthor (every asset uploaded by a given contributor)
• Content types: vectors, photos, videos, PSD templates, SVGs, PNGs, editable templates, motion graphics, editorial photos, editorial event galleries
• Filters: license (free / pro / editorial), sort order (best match / newest), orientation (horizontal / vertical / square / panoramic), dominant color (hex)
• Contributor info: author name, profile URL, avatar, and (in assetDetail mode) total resource count
• Empty fields are omitted

Output per asset

• assetId — numeric Vecteezy resource ID
• title
• assetType — vector / photo / video / psd / png / bundle / editor_template / motion_graphic / editorial_image / editorial_event / editorial (URL-only detail lookups, where the sub-type can't be told apart)
• isPro — true for Pro-license assets, false for free (search/byAuthor modes only)
• sourceUrl — canonical asset page URL
• thumbnailUrl, previewUrl — CDN image/video URLs
• previewWidth, previewHeight — thumbnail pixel dimensions (search/byAuthor modes only)
• licenseUrl — Vecteezy license terms page
• uploadDate
• authorName, authorProfileUrl, authorAvatarUrl
• authorId — numeric contributor ID (search/byAuthor modes only)
• authorResourceCount — total assets by this contributor (assetDetail mode only)
• keywords — related search keywords for the asset (assetDetail mode only)
• recordType: "asset", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / assetDetail / byAuthor
searchQuery	string	business	Keyword or category slug (mode=search)
contentType	string	vector	vector / photo / video / psd / svg / png / editor_template / motion_graphic / editorial_image / editorial_event
license	string	all	all / free / pro / editorial
sortBy	string	best	best / newest
orientation	string	all	all / horizontal / vertical / square / panoramic
colorHex	string	–	Dominant color hex, e.g. ff0000
assetUrls	array	–	Full asset URLs (mode=assetDetail); not supported for /edit/... template URLs
authorUsername	string	paintingred	Contributor username or profile URL (mode=byAuthor)
maxItems	int	50	Hard cap (1–1000)

Example: newest free photos, vertical orientation

{
  "mode": "search",
  "searchQuery": "nature",
  "contentType": "photo",
  "license": "free",
  "sortBy": "newest",
  "orientation": "vertical",
  "maxItems": 100
}

Example: browse a vector category

{
  "mode": "search",
  "searchQuery": "business",
  "contentType": "vector",
  "maxItems": 50
}

Example: asset detail lookup

{
  "mode": "assetDetail",
  "assetUrls": [
    "https://www.vecteezy.com/vector-art/141739-business-icons"
  ]
}

Example: browse editable templates

{
  "mode": "search",
  "searchQuery": "business card",
  "contentType": "editor_template",
  "maxItems": 50
}

Example: browse a contributor's full upload catalog

{
  "mode": "byAuthor",
  "authorUsername": "paintingred",
  "maxItems": 100
}

Use cases

• Design research — survey what stock assets exist for a given topic/niche before commissioning custom work
• Content curation — build mood boards or reference sets from free/Pro asset metadata
• Marketplace monitoring — track new uploads (sortBy: newest) in a category over time
• Licensing audits — verify license type and terms URL for assets already in use
• Contributor research — look up a creator's total resource count and profile via assetDetail, or pull their entire portfolio via byAuthor
• Template sourcing — find editable business-card/resume/flyer templates via contentType: editor_template
• Video production — source motion graphics overlays/presets via contentType: motion_graphic
• Editorial/news research — pull editorial (non-commercial-license) photos and event galleries via contentType: editorial_image / editorial_event
• Keyword research — mine an asset's related keywords (keywords field, assetDetail mode) to see how Vecteezy's own tagging associates a topic

FAQ

Does this require a Vecteezy account or API key? No. All fields come from Vecteezy's public search/browse pages and asset detail pages, which are visible to anonymous visitors.

What's the difference between search mode with a keyword vs a category name? None — Vecteezy's search and category-browse pages share the same URL pattern (/free-{type}/{term}), so passing a category slug (e.g. business) as searchQuery browses that category, while a free-text keyword searches it.

Why does an SVG search return assetType: "vector"? SVGs are a vector sub-format on Vecteezy; the site tags them internally as vector even though the browse URL (/free-svg/...) and download format differ. The contentType input still correctly scopes the search to SVG-capable assets.

Can I get download counts or likes? No — Vecteezy doesn't expose these on public pages (they load only for logged-in/Pro accounts), so the actor never fabricates them.

What does colorHex actually filter? It biases Vecteezy's own color-similarity ranking toward the given hex value; it's not a strict binary include/exclude filter, since Vecteezy computes it as a similarity threshold server-side.

Is isPro populated in assetDetail mode? No — the asset detail page doesn't expose a clean free/Pro flag the way grid pages do, so assetDetail records omit isPro rather than guessing.

Can I look up an editable template (contentType: editor_template) by URL in assetDetail mode? No. Template asset pages (/edit/{uuid}) are a client-rendered editor tool with no server-side asset metadata in the initial HTML — Vecteezy only serves a generic "Vecteezy Editor" placeholder there. Templates are fully covered (title, thumbnails, license, author, dimensions) via mode: search with contentType: editor_template instead; assetDetail simply skips /edit/... URLs rather than emit an incomplete/inaccurate record.

Does byAuthor mode respect the contentType filter? No — a contributor's /uploads page mixes every content type they've published (vectors, photos, templates, etc.), which matches Vecteezy's own page behavior. license and maxItems still apply.

Why does assetType: "editorial" show up instead of editorial_image/editorial_event? Only in assetDetail mode. Vecteezy's editorial detail pages report identical JSON-LD (ImageObject) for both sub-types, so the URL path alone can't tell them apart. search/byAuthor mode results are always precisely editorial_image or editorial_event, since that comes from the grid item's own type attribute, not the URL.

Is there an "AI-generated" filter? Vecteezy's search UI shows an "AI Generated" filter checkbox, but it was verified (live, side-by-side request comparison) to have no effect on the server-rendered result set when requested via plain HTTP — it only works through the site's client-side JavaScript. Since it can't be reliably applied, this actor does not expose it rather than ship a filter that silently does nothing.