MagicScreenshots Functions API

The Functions API from MagicScreenshots — 4 operation(s) for functions.

GitHub OpenAPI

Operations 4

POST /functions/v1/get-app-screenshots Fetch App Store screenshots for an app #
POST /functions/v1/agent-api MagicScreenshots agent workflow API #
POST /functions/v1/process-restyle Process a restyle job group #
POST /functions/v1/process-translate Process a screenshot localization job #

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/magicscreenshots-com:magicscreenshots-com-functions-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

magicscreenshots-com-functions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MagicScreenshots Functions API
  version: 1.0.0
  description: Machine-readable API description for MagicScreenshots App Store screenshot import, restyle, localization, and agent discovery workflows.
  contact:
    email: support@humanleap.com
servers:
- url: https://xpzoprjuvscmpywxwfug.supabase.co
  description: Supabase Edge Functions
- url: https://www.magicscreenshots.com
  description: MagicScreenshots discovery and MCP endpoints
security:
- SupabaseBearer: []
tags:
- name: Functions
paths:
  /functions/v1/get-app-screenshots:
    post:
      operationId: getAppScreenshots
      summary: Fetch App Store screenshots for an app
      description: Imports public App Store metadata and screenshot URLs for a submitted App Store URL.
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - url
              properties:
                url:
                  type: string
                  format: uri
                  description: Apple App Store app URL.
                country:
                  type: string
                  minLength: 2
                  maxLength: 2
                  description: Optional two-letter App Store country code.
      responses:
        '200':
          description: Imported app metadata and screenshot URLs.
      tags:
      - Functions
  /functions/v1/agent-api:
    post:
      operationId: agentApi
      summary: MagicScreenshots agent workflow API
      description: Authenticated REST API for agents. Use an action field to create an API key (no auth), fetch App Store screenshots, create restyle or localization jobs, approve final extraction, poll job groups, list recent results, and (Library Pro keys) get preview video download links (get_app_videos) or listing history (get_app_history) for a library app by app_id. For the public screenshot directory, use the MCP tools list_directory_apps and get_directory_app on /api/mcp (no key). create_restyle and create_localize use Autumn credits when available. If credits are insufficient, the response is a Stripe MPP HTTP 402 challenge; retry the same request with Payment-Authorization. Read-only actions are free. HTTP x402 is not enabled.
      x-payment-info:
        intent: charge
        method: stripe
        protocol: mpp
        currency: usd
        amount: max(0.50, credits * 0.33) for cards/SPT; credits * 0.33 for stablecoin (min 0.01)
      security:
      - MagicScreenshotsApiKey: []
      - SupabaseBearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - action
              properties:
                action:
                  type: string
                  enum:
                  - create_api_key
                  - get_screenshots
                  - create_restyle
                  - create_localize
                  - approve_restyle
                  - get_job_group
                  - list_results
                  - get_app_videos
                  - get_app_history
                source_app:
                  type: object
                  description: Source app lookup object for create_restyle or create_localize. Supports query, app_url, app_id, and country.
                inspiration_app:
                  type: object
                  description: Inspiration app lookup object for create_restyle. Supports query, app_url, app_id, and country.
                group_id:
                  type: string
                  format: uuid
                app_id:
                  type: string
                  description: Apple numeric app ID of a library app, for get_app_videos and get_app_history. Find it with the MCP tool list_directory_apps (appId).
                target_locales:
                  type: array
                  description: Locale IDs such as JPN, DEU, FRA, BRA, or objects with language/country for create_localize.
                  items:
                    oneOf:
                    - type: string
                    - type: object
                      required:
                      - language
                      properties:
                        id:
                          type: string
                        language:
                          type: string
                        country:
                          type: string
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
              additionalProperties: true
      responses:
        '200':
          description: Agent API response.
        '202':
          description: Restyle job accepted.
        '401':
          description: Bearer token missing or invalid.
        '402':
          description: 'Insufficient Autumn credits. When Stripe machine payments are configured, this is an MPP challenge (WWW-Authenticate: Payment). Retry with a Payment-Authorization credential. Read-only actions do not return 402.'
      tags:
      - Functions
  /functions/v1/process-restyle:
    post:
      operationId: processRestyle
      summary: Process a restyle job group
      description: Runs authenticated AI style transfer for an existing screenshot job group.
      x-payment-info:
        intent: charge
        method: stripe
        currency: credits
        amount: varies_by_screenshot_count
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                group_id:
                  type: string
                  format: uuid
                app_id:
                  type: string
                  description: Apple numeric app ID of a library app, for get_app_videos and get_app_history. Find it with the MCP tool list_directory_apps (appId).
                job_id:
                  type: string
                  format: uuid
              anyOf:
              - required:
                - group_id
              - required:
                - job_id
      responses:
        '202':
          description: Restyle job accepted.
        '401':
          description: Bearer token missing or invalid.
      tags:
      - Functions
  /functions/v1/process-translate:
    post:
      operationId: processTranslate
      summary: Process a screenshot localization job
      description: Runs authenticated AI screenshot translation and layout adaptation for a queued job.
      x-payment-info:
        intent: charge
        method: stripe
        currency: credits
        amount: varies_by_screenshot_count
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - job_id
              properties:
                job_id:
                  type: string
                  format: uuid
      responses:
        '202':
          description: Translation job accepted.
        '401':
          description: Bearer token missing or invalid.
      tags:
      - Functions
components:
  securitySchemes:
    SupabaseBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Supabase Auth JWT issued by https://xpzoprjuvscmpywxwfug.supabase.co/auth/v1.
    MagicScreenshotsApiKey:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: MagicScreenshots API key beginning with ms_live_. Create one in Settings > API.