LovPics Marketer API
The marketer API from LovPics — 14 operation(s) for marketer.
The marketer API from LovPics — 14 operation(s) for marketer.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/lovpics-com:lovpics-com-marketer-api"
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.
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: 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