LovPics Campaign Factory API

The campaign-factory API from LovPics — 9 operation(s) for campaign-factory.

GitHub OpenAPI

Operations 9

POST /api/campaign-factory/parse-csv Parse a CSV product catalogue into normalized product rows for Campaign Creator #
POST /api/campaign-factory/extract-product Extract structured product details from a product image, product URL, or CSV… #
POST /api/campaign-factory/plan Generate a complete multi-format campaign plan, scripts, and predicted… #
POST /api/campaign-factory/campaigns/{cfc_id}/enqueue Approve campaign plan, check credits, and enqueue selected deliverables… #
POST /api/campaign-factory/campaigns/{cfc_id}/regenerate-section Regenerate a specific campaign section (strategy, hooks, or analytics) in-place #
POST /api/campaign-factory/campaigns/{cfc_id}/items/{cfi_id}/regenerate-spec Regenerate the creative copy, prompt, or spoken script for a single deliverable… #
POST /api/campaign-factory/campaigns/{cfc_id}/items/{cfi_id}/regenerate Queue a single campaign deliverable item for generation or regeneration #
GET /api/campaign-factory/campaigns List the user's Campaign Creator campaigns with progress and predicted analytics #
GET /api/campaign-factory/campaigns/{cfc_id} Get a single Campaign Creator campaign with live item queue status, output… #

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-campaign-factory-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-campaign-factory-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Virtual Studio Campaign Factory API
  version: 0.1.0
tags:
- name: campaign-factory
paths:
  /api/campaign-factory/parse-csv:
    post:
      tags:
      - campaign-factory
      summary: Parse a CSV product catalogue into normalized product rows for Campaign Creator
      operationId: parse_csv_catalogue_api_campaign_factory_parse_csv_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ParseCsvRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryCsvResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/campaign-factory/extract-product:
    post:
      tags:
      - campaign-factory
      summary: Extract structured product details from a product image, product URL, or CSV…
      operationId: extract_product_api_campaign_factory_extract_product_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExtractProductRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryProductResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/campaign-factory/plan:
    post:
      tags:
      - campaign-factory
      summary: Generate a complete multi-format campaign plan, scripts, and predicted…
      operationId: plan_campaign_factory_api_campaign_factory_plan_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlanCampaignFactoryRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/campaign-factory/campaigns/{cfc_id}/enqueue:
    post:
      tags:
      - campaign-factory
      summary: Approve campaign plan, check credits, and enqueue selected deliverables…
      operationId: enqueue_campaign_factory_api_campaign_factory_campaigns__cfc_id__enqueue_post
      security:
      - HTTPBearer: []
      parameters:
      - name: cfc_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfc Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnqueueCampaignFactoryRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/campaign-factory/campaigns/{cfc_id}/regenerate-section:
    post:
      tags:
      - campaign-factory
      summary: Regenerate a specific campaign section (strategy, hooks, or analytics) in-place
      operationId: regenerate_campaign_section_api_campaign_factory_campaigns__cfc_id__regenerate_section_post
      security:
      - HTTPBearer: []
      parameters:
      - name: cfc_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfc Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegenerateSectionRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/campaign-factory/campaigns/{cfc_id}/items/{cfi_id}/regenerate-spec:
    post:
      tags:
      - campaign-factory
      summary: Regenerate the creative copy, prompt, or spoken script for a single deliverable…
      operationId: regenerate_campaign_item_spec_api_campaign_factory_campaigns__cfc_id__items__cfi_id__regenerate_spec_post
      security:
      - HTTPBearer: []
      parameters:
      - name: cfc_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfc Id
      - name: cfi_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfi Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/campaign-factory/campaigns/{cfc_id}/items/{cfi_id}/regenerate:
    post:
      tags:
      - campaign-factory
      summary: Queue a single campaign deliverable item for generation or regeneration
      operationId: regenerate_campaign_item_creative_api_campaign_factory_campaigns__cfc_id__items__cfi_id__regenerate_post
      security:
      - HTTPBearer: []
      parameters:
      - name: cfc_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfc Id
      - name: cfi_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfi Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegenerateDeliverableItemRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/campaign-factory/campaigns:
    get:
      tags:
      - campaign-factory
      summary: List the user's Campaign Creator campaigns with progress and predicted analytics
      operationId: list_campaign_factory_campaigns_api_campaign_factory_campaigns_get
      security:
      - HTTPBearer: []
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 50
          minimum: 1
          default: 25
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/campaign-factory/campaigns/{cfc_id}:
    get:
      tags:
      - campaign-factory
      summary: Get a single Campaign Creator campaign with live item queue status, output…
      operationId: get_campaign_factory_campaign_api_campaign_factory_campaigns__cfc_id__get
      security:
      - HTTPBearer: []
      parameters:
      - name: cfc_id
        in: path
        required: true
        schema:
          type: integer
          title: Cfc Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignFactoryOneResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CampaignFactoryDeliverableItem:
      properties:
        itemId:
          type: integer
          title: Itemid
          examples:
          - 101
        campaignId:
          type: integer
          title: Campaignid
          examples:
          - 1
        itemType:
          type: string
          title: Itemtype
          examples:
          - ugc_reel
        language:
          type: string
          title: Language
          examples:
          - English
        status:
          type: string
          title: Status
          examples:
          - queued
        requiredCredits:
          type: integer
          title: Requiredcredits
          examples:
          - 60
        spec:
          additionalProperties: true
          type: object
          title: Spec
          examples:
          - creatorModelDescription: Warm Indian creator in a sunlit kitchen
            creatorModelImage: https://…/model.jpg
            title: The Purity Journey Reel (English)
            voiceoverScript: What really goes into your family's daily meal? Switch to Weeld today.
        outputUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Outputurl
          examples:
          - https://…/output.mp4
        creativeId:
          anyOf:
          - type: integer
          - type: 'null'
          title: Creativeid
          examples:
          - 501
        reelJobId:
          anyOf:
          - type: integer
          - type: 'null'
          title: Reeljobid
          examples:
          - 88
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      additionalProperties: true
      type: object
      required:
      - itemId
      - campaignId
      - itemType
      - language
      - status
      - requiredCredits
      title: CampaignFactoryDeliverableItem
    CampaignFactoryCsvResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        rows:
          items:
            $ref: '#/components/schemas/CampaignFactoryCsvRow'
          type: array
          title: Rows
      additionalProperties: true
      type: object
      required:
      - success
      - rows
      title: CampaignFactoryCsvResponse
    ApprovedDeliverableItem:
      properties:
        itemId:
          type: integer
          title: Itemid
          examples:
          - 101
        enabled:
          type: boolean
          title: Enabled
          default: true
        language:
          anyOf:
          - type: string
          - type: 'null'
          title: Language
          examples:
          - English
        spec:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Spec
          description: Updated deliverable spec (e.g. title, prompt, headline, voiceoverScript, creatorModelImage, creatorModelDescription)
      type: object
      required:
      - itemId
      title: ApprovedDeliverableItem
    RegenerateSectionRequest:
      properties:
        section:
          type: string
          title: Section
          description: 'Section to regenerate: ''strategy'', ''hooks'', or ''analytics'''
          default: strategy
          examples:
          - strategy
      type: object
      title: RegenerateSectionRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CampaignFactoryProductData:
      properties:
        productName:
          type: string
          title: Productname
          examples:
          - Weeld Wheat Powder
        brandName:
          anyOf:
          - type: string
          - type: 'null'
          title: Brandname
          examples:
          - Weeld
        category:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
          examples:
          - Food & Nutrition
        price:
          anyOf:
          - type: string
          - type: 'null'
          title: Price
          examples:
          - ₹349
        tagline:
          anyOf:
          - type: string
          - type: 'null'
          title: Tagline
          examples:
          - 100% Pure & Natural Goodness
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
          examples:
          - Stone-ground whole wheat powder packed with natural nutrients and zero preservatives.
        keyBenefits:
          items:
            type: string
          type: array
          title: Keybenefits
          examples:
          - - 100% Natural
            - Zero Preservatives
            - Rich in Fiber
        productImageUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Productimageurl
          examples:
          - https://…/product.jpg
      additionalProperties: true
      type: object
      required:
      - productName
      title: CampaignFactoryProductData
    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
    CampaignFactoryCsvRow:
      properties:
        rowIndex:
          type: integer
          title: Rowindex
          examples:
          - 1
        sku:
          type: string
          title: Sku
          examples:
          - SKU-101
        productName:
          type: string
          title: Productname
          examples:
          - Artisanal Brass Coffee Filter
        category:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
          examples:
          - Home & Kitchen
        price:
          anyOf:
          - type: string
          - type: 'null'
          title: Price
          examples:
          - ₹1,499
        brand:
          anyOf:
          - type: string
          - type: 'null'
          title: Brand
          examples:
          - Kumbakonam Craft
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
          examples:
          - Handcrafted pure brass South Indian filter
        imageUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Imageurl
          examples:
          - https://…/product.jpg
        productUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Producturl
          examples:
          - https://example.com/products/brass-filter
      additionalProperties: true
      type: object
      required:
      - rowIndex
      - sku
      - productName
      title: CampaignFactoryCsvRow
    CampaignFactoryListResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        campaigns:
          items:
            $ref: '#/components/schemas/CampaignFactoryCampaignRecord'
          type: array
          title: Campaigns
      additionalProperties: true
      type: object
      required:
      - success
      - campaigns
      title: CampaignFactoryListResponse
    EnqueueCampaignFactoryRequest:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ApprovedDeliverableItem'
          type: array
          title: Items
        brandKitId:
          anyOf:
          - type: integer
          - type: 'null'
          title: Brandkitid
      type: object
      title: EnqueueCampaignFactoryRequest
    ExtractProductRequest:
      properties:
        sourceType:
          type: string
          title: Sourcetype
          description: 'Input mode: ''image'', ''url'', or ''csv'''
          default: image
          examples:
          - image
        productImage:
          anyOf:
          - type: string
          - type: 'null'
          title: Productimage
          description: Base64 data URL or HTTP URL of product image
          examples:
          - https://…/product.jpg
        productUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Producturl
          description: Product page URL to scrape
          examples:
          - https://example.com/products/weeld-wheat
        csvRow:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Csvrow
          description: Selected product row from parse-csv
      type: object
      title: ExtractProductRequest
    CampaignFactoryCampaignRecord:
      properties:
        campaignId:
          type: integer
          title: Campaignid
          examples:
          - 1
        title:
          type: string
          title: Title
          examples:
          - Weeld Wheat Powder — Festive Purity Campaign
        sourceType:
          type: string
          title: Sourcetype
          examples:
          - image
        status:
          type: string
          title: Status
          examples:
          - processing
        totalCreditsEstimated:
          type: integer
          title: Totalcreditsestimated
          examples:
          - 88
        creditsConsumed:
          type: integer
          title: Creditsconsumed
          examples:
          - 28
        productData:
          $ref: '#/components/schemas/CampaignFactoryProductData'
        plan:
          additionalProperties: true
          type: object
          title: Plan
        predictedAnalytics:
          additionalProperties: true
          type: object
          title: Predictedanalytics
          examples:
          - conversionLiftEstimate: +28%
            estimatedCtrRange: 2.4% - 3.8%
            estimatedRoasRange: 3.2x - 4.6x
            overallScore: 91
        items:
          items:
            $ref: '#/components/schemas/CampaignFactoryDeliverableItem'
          type: array
          title: Items
      additionalProperties: true
      type: object
      required:
      - campaignId
      - title
      - sourceType
      - status
      - totalCreditsEstimated
      - creditsConsumed
      - productData
      title: CampaignFactoryCampaignRecord
    CampaignFactoryOneResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        campaign:
          $ref: '#/components/schemas/CampaignFactoryCampaignRecord'
      additionalProperties: true
      type: object
      required:
      - success
      - campaign
      title: CampaignFactoryOneResponse
    CampaignFactoryProductResponse:
      properties:
        success:
          type: boolean
          title: Success
          examples:
          - true
        product:
          $ref: '#/components/schemas/CampaignFactoryProductData'
      additionalProperties: true
      type: object
      required:
      - success
      - product
      title: CampaignFactoryProductResponse
    PlanCampaignFactoryRequest:
      properties:
        sourceType:
          type: string
          title: Sourcetype
          default: image
          examples:
          - image
        productData:
          additionalProperties: true
          type: object
          title: Productdata
          examples:
          - brandName: Weeld
            category: Food & Nutrition
            description: 100% natural whole wheat powder with zero preservatives.
            productImageUrl: https://…/product.jpg
            productName: Weeld Wheat Powder
        campaignGoal:
          type: string
          title: Campaigngoal
          default: Drive Direct Conversions & ROAS
        targetAudience:
          type: string
          title: Targetaudience
          default: Online shoppers
        targetMarket:
          type: string
          title: Targetmarket
          default: India
        languages:
          items:
            type: string
          type: array
          title: Languages
        brandKitId:
          anyOf:
          - type: integer
          - type: 'null'
          title: Brandkitid
        creatorModelImage:
          anyOf:
          - type: string
          - type: 'null'
          title: Creatormodelimage
          description: Optional creator/model reference image URL for UGC reels and lifestyle ads
          examples:
          - https://…/model.jpg
        creatorModelDescription:
          anyOf:
          - type: string
          - type: 'null'
          title: Creatormodeldescription
          description: Optional creator/model description for UGC reels
          examples:
          - Indian creator in a bright modern kitchen
        additionalInstructions:
          anyOf:
          - type: string
          - type: 'null'
          title: Additionalinstructions
      type: object
      required:
      - productData
      title: PlanCampaignFactoryRequest
    RegenerateDeliverableItemRequest:
      properties:
        spec:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Spec
          description: Optional updated spec overrides (prompt, headline, voiceoverScript, creatorModelImage, creatorModelDescription) before regenerating
          examples:
          - creatorModelDescription: Indian creator in a sunlit kitchen
            creatorModelImage: https://…/model.jpg
            title: The Purity Journey Reel (English)
            voiceoverScript: What really goes into your family's daily meal? Switch to Weeld today.
      type: object
      title: RegenerateDeliverableItemRequest
    ParseCsvRequest:
      properties:
        csvText:
          type: string
          title: Csvtext
          description: Raw CSV text content from a product catalogue
      type: object
      required:
      - csvText
      title: ParseCsvRequest
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer