LovPics Marketer API

The marketer API from LovPics — 14 operation(s) for marketer.

GitHub OpenAPI

Operations 18

GET /api/marketer/status Marketer Status #
GET /api/marketer/enrollment Get Marketer Enrollment #
PUT /api/marketer/enrollment Save Marketer Enrollment #
GET /api/marketer/social Marketer Get Social #
PUT /api/marketer/social Marketer Update Social #
POST /api/marketer/marketing-content/generate Generate Marketing Content #
GET /api/marketer/banners List Marketer Banners #
GET /api/marketer/coupon/lookup Public Coupon Lookup #
GET /api/marketer/dashboard-summary Marketer Dashboard Summary #
GET /api/marketer/coupon-apply-history Marketer Coupon Apply History #
GET /api/marketer/my-coupons Marketer My Coupons #
POST /api/marketer/coupons Marketer Create Coupon #
PATCH /api/marketer/coupons/{mc_id}/status Marketer Update Coupon Status #
GET /api/marketer/bank-details Marketer Get Bank Details #
PUT /api/marketer/bank-details Marketer Upsert Bank Details #
GET /api/marketer/my-transactions Marketer My Transactions #
GET /api/marketer/suggestions Marketer List Suggestions #
POST /api/marketer/suggestions Marketer Create Suggestion #

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-marketer-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-marketer-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Virtual Studio Marketer API
  version: 0.1.0
tags:
- name: marketer
paths:
  /api/marketer/status:
    get:
      tags:
      - marketer
      summary: Marketer Status
      description: Returns whether the current customer has a row in mrktr_details (enrolled marketer).
      operationId: marketer_status_api_marketer_status_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/marketer/enrollment:
    get:
      tags:
      - marketer
      summary: Get Marketer Enrollment
      description: Load customer defaults and existing mrktr_details + social rows for the enrollment form.
      operationId: get_marketer_enrollment_api_marketer_enrollment_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    put:
      tags:
      - marketer
      summary: Save Marketer Enrollment
      description: Save marketer profile to mrktr_details + mrktr_social_media_details and mirror location/name/mobile to customers.
      operationId: save_marketer_enrollment_api_marketer_enrollment_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketerEnrollmentPayload'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/marketer/social:
    get:
      tags:
      - marketer
      summary: Marketer Get Social
      description: Current marketer social profiles (same shape as enrollment `social`).
      operationId: marketer_get_social_api_marketer_social_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    put:
      tags:
      - marketer
      summary: Marketer Update Social
      description: Update mrktr_social_media_details only (empty platforms are omitted, not stored).
      operationId: marketer_update_social_api_marketer_social_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketerSocialUpdatePayload'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/marketer/marketing-content/generate:
    post:
      tags:
      - marketer
      summary: Generate Marketing Content
      description: 'Enrolled marketers only: generate Lovpics promo post + hashtags for a target platform via Gemini.'
      operationId: generate_marketing_content_api_marketer_marketing_content_generate_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketingContentGeneratePayload'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/marketer/banners:
    get:
      tags:
      - marketer
      summary: List Marketer Banners
      description: Recent marketer banner assets (mrktr_banners) with public URLs.
      operationId: list_marketer_banners_api_marketer_banners_get
      security:
      - HTTPBearer: []
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/marketer/coupon/lookup:
    get:
      tags:
      - marketer
      summary: Public Coupon Lookup
      description: 'Public endpoint: look up a marketer coupon by code (no auth). Used on pricing checkout.'
      operationId: public_coupon_lookup_api_marketer_coupon_lookup_get
      parameters:
      - name: code
        in: query
        required: true
        schema:
          type: string
          title: Code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/marketer/dashboard-summary:
    get:
      tags:
      - marketer
      summary: Marketer Dashboard Summary
      description: 'Aggregates for marketer dashboard: transactions, coupons, apply-log counts.


        Omit date_from/date_to for all-time totals. When either is set, metrics are scoped by

        row timestamps (mt_added_on, mc_added_on, mca_added_on respectively).'
      operationId: marketer_dashboard_summary_api_marketer_dashboard_summary_get
      security:
      - HTTPBearer: []
      parameters:
      - name: date_from
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date From
      - name: date_to
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date To
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/marketer/coupon-apply-history:
    get:
      tags:
      - marketer
      summary: Marketer Coupon Apply History
      description: Coupon apply events for this marketer with referred customer display name.
      operationId: marketer_coupon_apply_history_api_marketer_coupon_apply_history_get
      security:
      - HTTPBearer: []
      parameters:
      - name: date_from
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date From
      - name: date_to
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date To
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/marketer/my-coupons:
    get:
      tags:
      - marketer
      summary: Marketer My Coupons
      operationId: marketer_my_coupons_api_marketer_my_coupons_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/marketer/coupons:
    post:
      tags:
      - marketer
      summary: Marketer Create Coupon
      description: 'Free (non-subscriber) marketers may create at most one coupon total.

        Lovpics subscribers may create additional coupons.

        Discount is fixed server-side (MARKETER_COUPON_DEFAULT_PERCENT).'
      operationId: marketer_create_coupon_api_marketer_coupons_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketerCreateCouponPayload'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/marketer/coupons/{mc_id}/status:
    patch:
      tags:
      - marketer
      summary: Marketer Update Coupon Status
      description: Only Lovpics subscribers may activate or deactivate their coupons (mc_status on mrktr_coupons).
      operationId: marketer_update_coupon_status_api_marketer_coupons__mc_id__status_patch
      security:
      - HTTPBearer: []
      parameters:
      - name: mc_id
        in: path
        required: true
        schema:
          type: integer
          title: Mc Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarketerCouponStatusPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/marketer/bank-details:
    get:
      tags:
      - marketer
      summary: Marketer Get Bank Details
      description: Active payout bank row for this marketer (mrktr_bank_details).
      operationId: marketer_get_bank_details_api_marketer_bank_details_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    put:
      tags:
      - marketer
      summary: Marketer Upsert Bank Details
      description: Insert a new active bank row; mark any previous active rows for this marketer as inactive.
      operationId: marketer_upsert_bank_details_api_marketer_bank_details_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MrktrBankDetailsPayload'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/marketer/my-transactions:
    get:
      tags:
      - marketer
      summary: Marketer My Transactions
      operationId: marketer_my_transactions_api_marketer_my_transactions_get
      security:
      - HTTPBearer: []
      parameters:
      - name: date_from
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date From
      - name: date_to
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date To
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/marketer/suggestions:
    get:
      tags:
      - marketer
      summary: Marketer List Suggestions
      description: All suggestions submitted by the current marketer (mrktr_suggestions).
      operationId: marketer_list_suggestions_api_marketer_suggestions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    post:
      tags:
      - marketer
      summary: Marketer Create Suggestion
      description: Submit a suggestion with optional image or PDF attachment (stored in GCS; path in msq_path).
      operationId: marketer_create_suggestion_api_marketer_suggestions_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_marketer_create_suggestion_api_marketer_suggestions_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MrktrBankDetailsPayload:
      properties:
        mbd_bank_name:
          type: string
          minLength: 1
          title: Mbd Bank Name
        mbd_account_no:
          type: string
          minLength: 1
          title: Mbd Account No
        mbd_name:
          type: string
          minLength: 1
          title: Mbd Name
        mbd_branch:
          anyOf:
          - type: string
          - type: 'null'
          title: Mbd Branch
        mbd_ifsc:
          type: string
          minLength: 1
          title: Mbd Ifsc
      type: object
      required:
      - mbd_bank_name
      - mbd_account_no
      - mbd_name
      - mbd_ifsc
      title: MrktrBankDetailsPayload
    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
    MarketerSocialUpdatePayload:
      properties:
        instagram_profile:
          anyOf:
          - type: string
          - type: 'null'
          title: Instagram Profile
        instagram_followers:
          anyOf:
          - type: string
          - type: 'null'
          title: Instagram Followers
        facebook_profile:
          anyOf:
          - type: string
          - type: 'null'
          title: Facebook Profile
        facebook_followers:
          anyOf:
          - type: string
          - type: 'null'
          title: Facebook Followers
        youtube_profile:
          anyOf:
          - type: string
          - type: 'null'
          title: Youtube Profile
        youtube_followers:
          anyOf:
          - type: string
          - type: 'null'
          title: Youtube Followers
      type: object
      title: MarketerSocialUpdatePayload
    MarketerCouponStatusPayload:
      properties:
        mc_status:
          type: integer
          title: Mc Status
          description: 1 = Active, 2 = Inactive
      type: object
      required:
      - mc_status
      title: MarketerCouponStatusPayload
    Body_marketer_create_suggestion_api_marketer_suggestions_post:
      properties:
        msq_suggestion:
          type: string
          title: Msq Suggestion
        file:
          anyOf:
          - type: string
            format: binary
          - type: 'null'
          title: File
      type: object
      required:
      - msq_suggestion
      title: Body_marketer_create_suggestion_api_marketer_suggestions_post
    MarketerEnrollmentPayload:
      properties:
        md_name:
          type: string
          minLength: 1
          title: Md Name
        md_mobile:
          anyOf:
          - type: string
          - type: 'null'
          title: Md Mobile
        md_address:
          anyOf:
          - type: string
          - type: 'null'
          title: Md Address
        md_country:
          anyOf:
          - type: integer
          - type: 'null'
          title: Md Country
        md_state:
          anyOf:
          - type: integer
          - type: 'null'
          title: Md State
        md_city:
          anyOf:
          - type: integer
          - type: 'null'
          title: Md City
        md_pincode:
          anyOf:
          - type: integer
          - type: 'null'
          title: Md Pincode
        md_work_experience:
          anyOf:
          - type: integer
          - type: 'null'
          title: Md Work Experience
        md_last_company:
          anyOf:
          - type: string
          - type: 'null'
          title: Md Last Company
        md_aadhar_no:
          anyOf:
          - type: string
          - type: 'null'
          title: Md Aadhar No
        md_pan_no:
          anyOf:
          - type: string
          - type: 'null'
          title: Md Pan No
        instagram_profile:
          anyOf:
          - type: string
          - type: 'null'
          title: Instagram Profile
        instagram_followers:
          anyOf:
          - type: string
          - type: 'null'
          title: Instagram Followers
        facebook_profile:
          anyOf:
          - type: string
          - type: 'null'
          title: Facebook Profile
        facebook_followers:
          anyOf:
          - type: string
          - type: 'null'
          title: Facebook Followers
        youtube_profile:
          anyOf:
          - type: string
          - type: 'null'
          title: Youtube Profile
        youtube_followers:
          anyOf:
          - type: string
          - type: 'null'
          title: Youtube Followers
      type: object
      required:
      - md_name
      title: MarketerEnrollmentPayload
    MarketingContentGeneratePayload:
      properties:
        platform:
          type: string
          maxLength: 32
          minLength: 1
          title: Platform
        aspect_ratio:
          anyOf:
          - type: string
            maxLength: 16
          - type: 'null'
          title: Aspect Ratio
          description: Omit for platform default (Instagram/LinkedIn/Facebook/Common 3:4, X 1:1). Else 1:1, 3:4, 4:5, etc.
      type: object
      required:
      - platform
      title: MarketingContentGeneratePayload
    MarketerCreateCouponPayload:
      properties:
        mc_coupon:
          type: string
          maxLength: 64
          minLength: 1
          title: Mc Coupon
      type: object
      required:
      - mc_coupon
      title: MarketerCreateCouponPayload
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer