v1

latestOpenAPI 3.1.02026-07-22134.8 KB
Screens

Search screens with natural language

Search Mobbin for screens using natural language. Returns relevant screens with image URLs, app names, and links to Mobbin.

post/v1/screens/search

Request body

querystring required

Describe one screen in plain language — the UI elements you'd see and how they relate. Be specific; detail helps. Good: "login screen with biometric authentication", "checkout page with promo code field and Apple Pay button". Avoid: combining multiple screens/intents (search separately), negations ("without ads"), vague style words ("modern", "clean"), disconnected keyword lists. Name a specific app to filter results to it (e.g. "Spotify now-playing screen"). Do not include platform (ios/web) — use the dedicated parameter.

platform'ios' | 'web' required

Platform to search

mode'deep' | 'standard' | 'fast'

Search mode. "standard" returns results with low latency. "deep" uses an AI-powered pipeline that interprets intent and scores results for relevance — ideal for nuanced queries. "fast" is a deprecated alias for "standard" and will be removed in a future version — use "standard" instead.

limitinteger

Maximum number of screens to return

image_quality'optimized' | 'high'

"optimized" returns images sized for AI agents and most programmatic inspection. "high" returns larger images for detailed visual inspection.

exclude_screen_idsstring[]

Screen IDs to exclude from results

Example request

{
  "query": "login screen with biometric authentication"
}

Response

Search results

All 1 operations