Civitai Models & Creators Scraper

Search and extract AI models, creators, generated images, and tags from Civitai — the world's largest open AI art model sharing platform.

What does this actor do?

Civitai hosts hundreds of thousands of community-trained AI models including Stable Diffusion Checkpoints, LoRAs, ControlNets, Embeddings, and more. This actor lets you:

• Search AI models by keyword, type, rating, and time period
• Browse creators and their published model counts
• Collect generated images with full generation metadata (prompt, seed, sampler, CFG scale)
• List tags used to categorize models on the platform
• Fetch specific models by ID or Civitai URL
• Get all models by a creator username

Data is fetched directly from the official Civitai REST API using cursor-based pagination to reliably retrieve large result sets.

Input

Field	Type	Description	Default
mode	Select	What to fetch: searchModels, searchCreators, searchImages, getTags, getModel, byUser	searchModels
searchQuery	Text	Free-text search query	—
modelIds	String List	Model IDs for direct lookup (mode=getModel)	—
startUrls	String List	Civitai model URLs for direct lookup (mode=getModel)	—
username	Text	Creator username for mode=byUser or image filter	—
modelType	Select	Filter by type: Checkpoint, LORA, ControlNet, VAE, etc.	—
sortBy	Select	Sort order: Highest Rated, Most Downloaded, Newest	Newest
period	Select	Time period: AllTime, Year, Month, Week, Day	AllTime
nsfwAllowed	Boolean	Include NSFW content in results	false
minRating	Number	Minimum average rating (0–5)	—
maxItems	Integer	Maximum number of records to emit (1–5000)	50
apiToken	Secret	Optional Civitai API token for higher rate limits	—

Output

Model record

Field	Type	Description
modelId	Integer	Unique Civitai model ID
name	String	Model name
type	String	Model type (Checkpoint, LORA, etc.)
nsfw	Boolean	Whether the model is marked NSFW
rating	Float	Average community rating (0–5)
ratingCount	Integer	Number of ratings
downloadCount	Integer	Total number of downloads
favoriteCount	Integer	Total favorites
commentCount	Integer	Total comments
tags	Array	List of tag strings
creator	Object	Creator username and image URL
versions	Array	Model versions with download URLs and preview images
url	String	Direct Civitai URL for the model
recordType	String	Always "model"
scrapedAt	String	ISO 8601 timestamp of extraction

Creator record

Field	Type	Description
username	String	Civitai username
avatarUrl	String	Profile image URL
modelCount	Integer	Number of published models
url	String	Profile page URL
recordType	String	Always "creator"
scrapedAt	String	ISO 8601 timestamp

Image record

Field	Type	Description
imageId	Integer	Unique image ID
url	String	Direct image URL
nsfw	String	NSFW level: None, Soft, Mature, X
width	Integer	Image width in pixels
height	Integer	Image height in pixels
meta	Object	Generation metadata: prompt, seed, steps, sampler, cfgScale
stats	Object	Reaction counts: likeCount, heartCount, etc.
username	String	Creator username
recordType	String	Always "image"
scrapedAt	String	ISO 8601 timestamp

Example output record

{
  "modelId": 12345,
  "name": "Ultra Realistic Portrait v2",
  "type": "Checkpoint",
  "nsfw": false,
  "rating": 4.87,
  "ratingCount": 512,
  "downloadCount": 198000,
  "favoriteCount": 5400,
  "commentCount": 220,
  "tags": ["portrait", "realistic", "photography"],
  "creator": {
    "username": "portrait_master",
    "image": "https://image.civitai.com/avatar.jpg"
  },
  "versions": [
    {
      "id": 67890,
      "name": "v2.0",
      "baseModel": "SD 1.5",
      "downloadUrl": "https://civitai.com/api/download/models/67890",
      "images": ["https://image.civitai.com/img1.jpg"]
    }
  ],
  "url": "https://civitai.com/models/12345",
  "recordType": "model",
  "scrapedAt": "2026-05-17T12:00:00+00:00"
}

FAQ

Do I need an API token? No. The Civitai API is publicly accessible without authentication. An optional API token from civitai.com/user/account increases your rate limits and may be required to access NSFW content above the default threshold.

How many results can I get? Up to 5,000 records per run using maxItems. The actor uses cursor-based pagination to retrieve all available results beyond the first page.

How fresh is the data? Data is fetched live from the Civitai API at the time of the actor run. Model download counts and ratings reflect the state at that moment.

Can I fetch a specific model I know the URL for? Yes. Use mode=getModel and provide either the Civitai model URL (e.g. https://civitai.com/models/12345) or just the numeric ID in modelIds.

Why are some NSFW models not appearing? By default nsfwAllowed is false. Enable it to include NSFW content. For full NSFW access, provide an API token from a Civitai account with NSFW permissions enabled.

What model types are supported? All Civitai model types: Checkpoint, TextualInversion (Embedding), Hypernetwork, AestheticGradient, LORA, LoCon, ControlNet, Upscaler, MotionModule, VAE, Poses, Wildcards, Workflows, and Other.

Can I get all models by a specific creator? Yes. Use mode=byUser and set username to the creator's Civitai username.

Limitations

• The Civitai API enforces rate limits on unauthenticated requests. Providing an API token increases the allowed request rate.
• Model file weights and binary data are not downloaded — only metadata and preview image URLs are extracted.
• Some NSFW content requires both nsfwAllowed=true and a valid API token from an account with appropriate settings.
• The versions[].downloadUrl links point to the Civitai CDN. Downloading model files requires a Civitai account in some cases.