Orbit Images API
Stock-photo catalog — hotlinkable, attributed photography for authored apps
Stock-photo catalog — hotlinkable, attributed photography for authored apps
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/orbitapps-io:orbitapps-io-images-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Orbit Apps Images API
version: 1.0.0
description: Public REST API for Orbit Apps.
servers:
- url: https://api.orbitapps.io
description: Production
security:
- bearerAuth: []
tags:
- name: Images
description: Stock-photo catalog — hotlinkable, attributed photography for authored apps
paths:
/api/v1/images/{slug}:
get:
parameters:
- in: path
name: slug
required: true
schema:
type: string
description: The image's slug, from a previous search hit.
responses:
'200':
description: The image.
content:
application/json:
schema:
title: ImageMatch
description: 'A search hit, directly placeable: hotlink `src`, render `blurhash` while loading, ALWAYS display `attribution`.'
type: object
properties:
role:
description: 'Placement hint: hero | avatar | thumbnail | background | gallery | logo.'
oneOf:
- type: string
- type: 'null'
description:
description: What the photo shows.
oneOf:
- type: string
- type: 'null'
thumb:
description: Smaller variant for grids.
oneOf:
- type: string
- type: 'null'
category:
description: Topic bucket, e.g. healthcare, saas, realestate, people. One value per topic set — a sub-specialty like dental or legal is searchable via `q`, not here.
oneOf:
- type: string
- type: 'null'
copy_space:
description: 'Where the photo stays flat enough for headline text to sit on it: left | right | top | bottom | center, or none when the frame is busy edge to edge. Put the copy on that side.'
oneOf:
- type: string
- type: 'null'
aspect:
description: Aspect ratio, e.g. 16:9.
oneOf:
- type: string
- type: 'null'
slug:
description: URL-safe handle. The path param on GET /images/{slug}.
type: string
color:
description: Dominant hex color — use as the loading background.
oneOf:
- type: string
- type: 'null'
license:
description: License identifier, e.g. unsplash.
oneOf:
- type: string
- type: 'null'
alt:
description: Accessibility text.
oneOf:
- type: string
- type: 'null'
width:
description: Source pixels.
oneOf:
- type: integer
- type: 'null'
orientation:
description: landscape | portrait | square.
oneOf:
- type: string
- type: 'null'
src:
description: Hotlink URL (provider CDN). Never mirror or re-host.
oneOf:
- type: string
- type: 'null'
source:
description: 'Provider: unsplash | pexels | pixabay | custom.'
oneOf:
- type: string
- type: 'null'
keywords:
description: Space-separated search keywords.
oneOf:
- type: string
- type: 'null'
blurhash:
description: BlurHash placeholder string for CLS-free loading.
oneOf:
- type: string
- type: 'null'
title:
description: Human-readable title.
oneOf:
- type: string
- type: 'null'
attribution:
description: Photographer credit — {photographer, username, profile_url, source_url}. Display wherever the image renders.
oneOf:
- type: object
additionalProperties: {}
- type: 'null'
height:
description: Source pixels.
oneOf:
- type: integer
- type: 'null'
required:
- slug
- title
- description
- category
- role
- orientation
- aspect
- width
- height
- color
- blurhash
- copy_space
- src
- alt
- attribution
additionalProperties: false
'404':
description: No image matches the slug.
content:
application/json:
schema:
type: object
properties: {}
additionalProperties: false
tags:
- Images
summary: Get one image
description: The full catalog entry, adding keywords / license / source to the search-hit shape.
operationId: getApiV1ImagesBySlug
x-operation-id-source: derived
/api/v1/images:
get:
parameters:
- in: query
name: q
required: false
schema:
type: string
description: Natural-language BM25 query, e.g. `"team working office"`. Omit for plain browse + filter.
- in: query
name: category
required: false
schema:
type: string
description: 'Topic filter: agency, ai, automotive, backgrounds, beauty, construction, creative, devtools, ecommerce, education, events, fintech, fitness, food, groceries, healthcare, home-services, logistics, marketing, nonprofit, people, pets, portraits, product, professional, realestate, restaurant, saas, sustainability, travel, wedding, wellness.'
- in: query
name: role
required: false
schema:
type: string
description: 'Placement filter: hero | avatar | thumbnail | background | gallery | logo.'
- in: query
name: orientation
required: false
schema:
type: string
enum:
- landscape
- portrait
- square
description: landscape | portrait | square.
- in: query
name: copy_space
required: false
schema:
type: string
enum:
- left
- right
- top
- bottom
- center
- none
description: Only images with room for headline text on this side. Use when picking a hero the copy has to sit on.
- in: query
name: limit
required: false
schema:
type: integer
minimum: 1
maximum: 100
description: Max rows. 1–100, default 20.
- in: query
name: offset
required: false
schema:
type: integer
minimum: 0
description: Result offset. Default 0.
responses:
'200':
description: Matching images, directly placeable.
content:
application/json:
schema:
title: ImageList
description: List envelope. `limit`/`offset` echo the query; detect end-of-results when `data.length < limit`.
type: object
properties:
data:
type: array
items:
title: ImageMatch
description: 'A search hit, directly placeable: hotlink `src`, render `blurhash` while loading, ALWAYS display `attribution`.'
type: object
properties:
role:
description: 'Placement hint: hero | avatar | thumbnail | background | gallery | logo.'
oneOf:
- type: string
- type: 'null'
description:
description: What the photo shows.
oneOf:
- type: string
- type: 'null'
thumb:
description: Smaller variant for grids.
oneOf:
- type: string
- type: 'null'
category:
description: Topic bucket, e.g. healthcare, saas, realestate, people. One value per topic set — a sub-specialty like dental or legal is searchable via `q`, not here.
oneOf:
- type: string
- type: 'null'
copy_space:
description: 'Where the photo stays flat enough for headline text to sit on it: left | right | top | bottom | center, or none when the frame is busy edge to edge. Put the copy on that side.'
oneOf:
- type: string
- type: 'null'
aspect:
description: Aspect ratio, e.g. 16:9.
oneOf:
- type: string
- type: 'null'
slug:
description: URL-safe handle. The path param on GET /images/{slug}.
type: string
color:
description: Dominant hex color — use as the loading background.
oneOf:
- type: string
- type: 'null'
alt:
description: Accessibility text.
oneOf:
- type: string
- type: 'null'
width:
description: Source pixels.
oneOf:
- type: integer
- type: 'null'
orientation:
description: landscape | portrait | square.
oneOf:
- type: string
- type: 'null'
src:
description: Hotlink URL (provider CDN). Never mirror or re-host.
oneOf:
- type: string
- type: 'null'
blurhash:
description: BlurHash placeholder string for CLS-free loading.
oneOf:
- type: string
- type: 'null'
title:
description: Human-readable title.
oneOf:
- type: string
- type: 'null'
attribution:
description: Photographer credit — {photographer, username, profile_url, source_url}. Display wherever the image renders.
oneOf:
- type: object
additionalProperties: {}
- type: 'null'
height:
description: Source pixels.
oneOf:
- type: integer
- type: 'null'
required:
- slug
- title
- description
- category
- role
- orientation
- aspect
- width
- height
- color
- blurhash
- copy_space
- src
- alt
- attribution
additionalProperties: false
limit:
type: integer
offset:
type: integer
required:
- data
- limit
- offset
additionalProperties: false
tags:
- Images
summary: Search and browse the image catalog
description: 'Curated stock photography for authored apps — use these instead of placeholder URLs.
Search semantics:
• Pass `q` for BM25 ranking across title, description, and keywords.
• Filter by `category` (topic set), `role` (placement hint: hero/avatar/background/...), `orientation`, and `copy_space` — the side of the frame headline text stays legible over. Filter on it whenever the copy sits on the image.
Hits are directly placeable: hotlink `src` (never mirror), render `blurhash`/`color` while loading, and ALWAYS display `attribution` near the image per the provider license.
Pagination is offset-based; detect end-of-results when `data.length < limit`.'
operationId: getApiV1Images
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: opaque
description: 'An Orbit api token, sent as `Authorization: Bearer <token>`.
Mint one with the RFC 8628 device-authorization grant (`POST /api/v1/device/code`, then poll `POST /api/v1/device/token`), or from Studio.
Every token carries a scope set from the `[verb resource]` RBAC catalog — `read:app`, `write:deployment`, `manage:secret`, and so on. The full vocabulary is published as `scopes_supported` at `/.well-known/oauth-protected-resource` (RFC 9728) and `/.well-known/oauth-authorization-server` (RFC 8414). Grant an agent the narrowest set that does its job.'
externalDocs:
description: Full documentation
url: https://docs.orbitapps.io
x-id:
- reitit.openapi/default