LovPics Creatives API

The creatives API from LovPics — 3 operation(s) for creatives.

GitHub OpenAPI

Operations 4

GET /api/creatives/ Get Creatives #
POST /api/creatives/ Create Creative #
GET /api/creatives/history Get Creatives History #
GET /api/creatives/stats Get Creative Stats #

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/lovpics-com:lovpics-com-creatives-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

lovpics-com-creatives-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Virtual Studio Creatives API
  version: 0.1.0
tags:
- name: Creatives
paths:
  /api/creatives/:
    get:
      tags:
      - Creatives
      summary: Get Creatives
      description: 'Get current user''s creative generation history with pagination and date filtering.


        Args:

        page: Page number (1-based)

        limit: Number of items per page (default 100)

        start_date: Start date for filtering (ISO format: YYYY-MM-DD)

        end_date: End date for filtering (ISO format: YYYY-MM-DD)

        current_user: Current authenticated user


        Returns:

        dict: List of creatives with usage history and pagination info'
      operationId: get_creatives_api_creatives__get
      security:
      - HTTPBearer: []
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          default: 1
          title: Page
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: start_date
        in: query
        required: false
        schema:
          type: string
          title: Start Date
      - name: end_date
        in: query
        required: false
        schema:
          type: string
          title: End Date
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreativeListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Creatives
      summary: Create Creative
      description: 'Create a new creative record.


        Args:

        payload: Creative data

        current_user: Current authenticated user


        Returns:

        dict: Created creative information'
      operationId: create_creative_api_creatives__post
      security:
      - HTTPBearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCreativePayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreativeOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/creatives/history:
    get:
      tags:
      - Creatives
      summary: Get Creatives History
      description: 'Get creative history for a specific type with pagination.

        Supports infinite scroll by returning paginated results.


        Args:

        crt_type: Creative type filter (supports extended studio types including AI Tools)

        page: Page number (1-based)

        limit: Number of items per page (default 10)

        current_user: Current authenticated user


        Returns:

        dict: List of creatives with pagination info'
      operationId: get_creatives_history_api_creatives_history_get
      security:
      - HTTPBearer: []
      parameters:
      - name: crt_type
        in: query
        required: true
        schema:
          type: integer
          maximum: 30
          minimum: 1
          description: 'Creative type: 1=Fashion Studio … 14=AI Tools …'
          title: Crt Type
        description: 'Creative type: 1=Fashion Studio … 14=AI Tools …'
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number (1-based)
          default: 1
          title: Page
        description: Page number (1-based)
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Items per page
          default: 10
          title: Limit
        description: Items per page
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreativeHistoryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/creatives/stats:
    get:
      tags:
      - Creatives
      summary: Get Creative Stats
      description: 'Get creative generation statistics for the current user.


        Returns:

        dict: Statistics about creative usage'
      operationId: get_creative_stats_api_creatives_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreativeStatsResponse'
      security:
      - HTTPBearer: []
components:
  schemas:
    CreateCreativePayload:
      properties:
        prompt:
          type: string
          title: Prompt
        credits:
          type: integer
          title: Credits
        path:
          type: string
          title: Path
        status:
          type: integer
          title: Status
          default: 1
        crt_type:
          type: integer
          title: Crt Type
          default: 1
      type: object
      required:
      - prompt
      - credits
      - path
      title: CreateCreativePayload
    CreativeListResponse:
      properties:
        ok:
          type: boolean
          title: Ok
          examples:
          - true
        creatives:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Creatives
        pagination:
          $ref: '#/components/schemas/Pagination'
      additionalProperties: true
      type: object
      required:
      - ok
      - creatives
      - pagination
      title: CreativeListResponse
    CreativeStatsResponse:
      properties:
        ok:
          type: boolean
          title: Ok
          examples:
          - true
        stats:
          $ref: '#/components/schemas/CreativeStats'
      additionalProperties: true
      type: object
      required:
      - ok
      - stats
      title: CreativeStatsResponse
    CreativeHistoryResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        creatives:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Creatives
        pagination:
          $ref: '#/components/schemas/Pagination'
      additionalProperties: true
      type: object
      required:
      - success
      - creatives
      - pagination
      title: CreativeHistoryResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CreativeStats:
      properties:
        total_creatives:
          type: integer
          title: Total Creatives
          examples:
          - 12
        successful_creatives:
          type: integer
          title: Successful Creatives
          examples:
          - 10
        failed_creatives:
          type: integer
          title: Failed Creatives
          examples:
          - 2
        total_credits_used:
          type: integer
          title: Total Credits Used
          examples:
          - 40
        average_credits_per_successful:
          type: number
          title: Average Credits Per Successful
          examples:
          - 4
      additionalProperties: true
      type: object
      required:
      - total_creatives
      - successful_creatives
      - failed_creatives
      - total_credits_used
      - average_credits_per_successful
      title: CreativeStats
    Pagination:
      properties:
        page:
          type: integer
          title: Page
          examples:
          - 1
        limit:
          type: integer
          title: Limit
          examples:
          - 20
        total_count:
          type: integer
          title: Total Count
          examples:
          - 42
        total_pages:
          anyOf:
          - type: integer
          - type: 'null'
          title: Total Pages
          examples:
          - 3
        has_next:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Has Next
          examples:
          - true
        has_prev:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Has Prev
          examples:
          - false
        has_more:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Has More
          examples:
          - true
      additionalProperties: true
      type: object
      required:
      - page
      - limit
      - total_count
      title: Pagination
    CreativeOneResponse:
      properties:
        ok:
          type: boolean
          title: Ok
          examples:
          - true
        creative:
          additionalProperties: true
          type: object
          title: Creative
      additionalProperties: true
      type: object
      required:
      - ok
      - creative
      title: CreativeOneResponse
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer