Orbit Images API

Stock-photo catalog — hotlinkable, attributed photography for authored apps

GitHub OpenAPI

Operations 2

GET /api/v1/images/{slug} Get one image #
GET /api/v1/images Search and browse the image catalog #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/orbitapps-io:orbitapps-io-images-api"
All apis
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.

Get an API 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 Specification

orbitapps-io-images-api-openapi.yml Raw ↑
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