InstaVeil X402 API

openapi: 3.2.0
info:
  title: InstaVeil Agent X402 API
  version: 1.0.0
  contact:
    name: InstaVeil
    url: https://instaveil.com/contact
    email: info@instaveil.com
  description: Agent-native paid access to InstaVeil public-profile data and analysis. Unpaid calls return an x402 v2 challenge; successful calls settle in USDC on Solana mainnet.
servers:
- url: https://instaveil.com
tags:
- name: X402
paths:
  /api/x402/profile-snapshot:
    post:
      operationId: profileSnapshot
      summary: 'Public Instagram profile lookup and creator enrichment for AI agents: follower…'
      x-agent-buyer-tasks:
      - vet an Instagram creator before a campaign
      - enrich a creator or influencer profile
      - look up public Instagram profile metadata
      - research a competitor Instagram account
      - collect public profile signals for campaign research
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - username
              properties:
                username:
                  type: string
                  pattern: ^[A-Za-z0-9._]{1,30}$
                  description: Public Instagram username without @
              additionalProperties: false
      x-x402:
        version: 2
        scheme: exact
        network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price: $0.01
        currency: USDC
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid result with PAYMENT-RESPONSE settlement receipt
        '400':
          description: Invalid input; no settlement
        '402':
          description: x402 Solana USDC payment required
        '503':
          description: Provider or settlement unavailable; no successful settlement
      tags:
      - X402
  /api/x402/story-snapshot:
    post:
      operationId: storySnapshot
      summary: Live public Instagram Story monitoring for creators, brands and competitors…
      x-agent-buyer-tasks:
      - check whether an Instagram creator has live Stories
      - monitor public Instagram Stories for a campaign
      - watch a competitor's current public Stories
      - track creator activity before or during a campaign
      - get Story expiry-aware public metadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - username
              properties:
                username:
                  type: string
                  pattern: ^[A-Za-z0-9._]{1,30}$
                  description: Public Instagram username without @
              additionalProperties: false
      x-x402:
        version: 2
        scheme: exact
        network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price: $0.05
        currency: USDC
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid result with PAYMENT-RESPONSE settlement receipt
        '400':
          description: Invalid input; no settlement
        '402':
          description: x402 Solana USDC payment required
        '503':
          description: Provider or settlement unavailable; no successful settlement
      tags:
      - X402
  /api/x402/profile-intelligence:
    post:
      operationId: profileIntelligence
      summary: 'Instagram creator and competitor intelligence for agent workflows: engagement…'
      x-agent-buyer-tasks:
      - perform creator due diligence
      - shortlist an influencer using public Instagram signals
      - analyze posting cadence and engagement
      - research a brand or competitor profile
      - prepare public-profile intelligence for a campaign agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - username
              properties:
                username:
                  type: string
                  pattern: ^[A-Za-z0-9._]{1,30}$
                  description: Public Instagram username without @
              additionalProperties: false
      x-x402:
        version: 2
        scheme: exact
        network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price: $0.15
        currency: USDC
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.15'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid result with PAYMENT-RESPONSE settlement receipt
        '400':
          description: Invalid input; no settlement
        '402':
          description: x402 Solana USDC payment required
        '503':
          description: Provider or settlement unavailable; no successful settlement
      tags:
      - X402
  /api/x402/creator-compare:
    post:
      operationId: creatorCompare
      summary: Compare two or three public Instagram creators or competitors in structured…
      x-agent-buyer-tasks:
      - compare Instagram creators for an influencer campaign
      - shortlist two or three creators using public signals
      - benchmark Instagram competitors side by side
      - compare engagement cadence and content mix across creators
      - prepare a structured creator comparison for a marketing agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - usernames
              properties:
                usernames:
                  type: array
                  minItems: 2
                  maxItems: 3
                  uniqueItems: true
                  items:
                    type: string
                    pattern: ^[A-Za-z0-9._]{1,30}$
                    description: Public Instagram username without @
              additionalProperties: false
      x-x402:
        version: 2
        scheme: exact
        network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price: $0.29
        currency: USDC
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.29'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid result with PAYMENT-RESPONSE settlement receipt
        '400':
          description: Invalid input; no settlement
        '402':
          description: x402 Solana USDC payment required
        '503':
          description: Provider or settlement unavailable; no successful settlement
      tags:
      - X402
  /api/x402/veil-lens:
    post:
      operationId: veilLens
      summary: 'Cross-profile Instagram analysis for agents: compare one to three public…'
      x-agent-buyer-tasks:
      - compare Instagram creators for a campaign
      - benchmark competitors across public profiles
      - choose between creators using public signals
      - synthesize recent public Instagram activity
      - answer a cross-profile campaign research question
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - usernames
              - question
              properties:
                usernames:
                  type: array
                  minItems: 1
                  maxItems: 3
                  uniqueItems: true
                  items:
                    type: string
                    pattern: ^[A-Za-z0-9._]{1,30}$
                    description: Public Instagram username without @
                question:
                  type: string
                  minLength: 5
                  maxLength: 600
                language:
                  type: string
                  enum:
                  - English
                  - Ελληνικά
                  - Español
                  - Português
                  - Italiano
                  - Français
                  - Deutsch
                  - 日本語
                  - 한국어
                  - العربية
                images:
                  type: boolean
                  enum:
                  - false
                  default: false
                  description: Agent API v1 uses text analysis for predictable per-call cost.
              additionalProperties: false
      x-x402:
        version: 2
        scheme: exact
        network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
        price: $0.75
        currency: USDC
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.75'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Paid result with PAYMENT-RESPONSE settlement receipt
        '400':
          description: Invalid input; no settlement
        '402':
          description: x402 Solana USDC payment required
        '503':
          description: Provider or settlement unavailable; no successful settlement
      tags:
      - X402
x-instaveil-catalog:
  name: InstaVeil Agent API
  version: 1
  protocol: x402-v2
  network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
  settlement: Solana mainnet USDC
  non_custodial: true
  facilitator: https://facilitator.payai.network
  payment_recipient: resolved server-side
  products:
  - id: profile-snapshot
    title: Public Profile Snapshot
    method: POST
    resource: https://instaveil.com/api/x402/profile-snapshot
    price: $0.01
    description: 'Public Instagram profile lookup and creator enrichment for AI agents: follower, following and post counts plus recent public media. Built for creator vetting, influencer research, lead enrichment, campaign research and competitor monitoring.'
    tags:
    - instagram
    - creator-research
    - enrichment
    - agents
    - x402
    buyer_tasks:
    - vet an Instagram creator before a campaign
    - enrich a creator or influencer profile
    - look up public Instagram profile metadata
    - research a competitor Instagram account
    - collect public profile signals for campaign research
    input_schema:
      type: object
      required:
      - username
      properties:
        username:
          type: string
          pattern: ^[A-Za-z0-9._]{1,30}$
          description: Public Instagram username without @
      additionalProperties: false
    input_example:
      username: instagram
  - id: story-snapshot
    title: Live Story Snapshot
    method: POST
    resource: https://instaveil.com/api/x402/story-snapshot
    price: $0.05
    description: 'Live public Instagram Story monitoring for creators, brands and competitors: current Story count, media metadata and truthful expiry provenance. Built for campaign monitoring, creator activity checks and competitor Story research.'
    tags:
    - instagram
    - stories
    - monitoring
    - creator-research
    - x402
    buyer_tasks:
    - check whether an Instagram creator has live Stories
    - monitor public Instagram Stories for a campaign
    - watch a competitor's current public Stories
    - track creator activity before or during a campaign
    - get Story expiry-aware public metadata
    input_schema:
      type: object
      required:
      - username
      properties:
        username:
          type: string
          pattern: ^[A-Za-z0-9._]{1,30}$
          description: Public Instagram username without @
      additionalProperties: false
    input_example:
      username: instagram
  - id: profile-intelligence
    title: Profile Intelligence Report
    method: POST
    resource: https://instaveil.com/api/x402/profile-intelligence
    price: $0.15
    description: 'Instagram creator and competitor intelligence for agent workflows: engagement, posting cadence, content mix and data-coverage signals. Built for creator due diligence, influencer shortlisting, campaign research and competitor analysis.'
    tags:
    - instagram
    - creator-vetting
    - competitor-analysis
    - research
    - x402
    buyer_tasks:
    - perform creator due diligence
    - shortlist an influencer using public Instagram signals
    - analyze posting cadence and engagement
    - research a brand or competitor profile
    - prepare public-profile intelligence for a campaign agent
    input_schema:
      type: object
      required:
      - username
      properties:
        username:
          type: string
          pattern: ^[A-Za-z0-9._]{1,30}$
          description: Public Instagram username without @
      additionalProperties: false
    input_example:
      username: instagram
  - id: creator-compare
    title: Instagram Creator Comparison
    method: POST
    resource: https://instaveil.com/api/x402/creator-compare
    price: $0.29
    description: 'Compare two or three public Instagram creators or competitors in structured JSON: audience size, engagement, posting cadence, consistency, momentum, content mix, live Story activity and data confidence. Built for influencer shortlisting, creator due diligence, campaign research and competitor benchmarking.'
    tags:
    - instagram
    - creator-comparison
    - campaign-research
    - marketing
    - x402
    buyer_tasks:
    - compare Instagram creators for an influencer campaign
    - shortlist two or three creators using public signals
    - benchmark Instagram competitors side by side
    - compare engagement cadence and content mix across creators
    - prepare a structured creator comparison for a marketing agent
    input_schema:
      type: object
      required:
      - usernames
      properties:
        usernames:
          type: array
          minItems: 2
          maxItems: 3
          uniqueItems: true
          items:
            type: string
            pattern: ^[A-Za-z0-9._]{1,30}$
            description: Public Instagram username without @
      additionalProperties: false
    input_example:
      usernames:
      - instagram
      - natgeo
  - id: veil-lens
    title: Veil Lens Agent Analysis
    method: POST
    resource: https://instaveil.com/api/x402/veil-lens
    price: $0.75
    description: 'Cross-profile Instagram analysis for agents: compare one to three public profiles and answer research questions with source-linked findings. Built for creator selection, competitor benchmarking and campaign planning.'
    tags:
    - instagram
    - comparison
    - creator-research
    - analysis
    - x402
    buyer_tasks:
    - compare Instagram creators for a campaign
    - benchmark competitors across public profiles
    - choose between creators using public signals
    - synthesize recent public Instagram activity
    - answer a cross-profile campaign research question
    input_schema:
      type: object
      required:
      - usernames
      - question
      properties:
        usernames:
          type: array
          minItems: 1
          maxItems: 3
          uniqueItems: true
          items:
            type: string
            pattern: ^[A-Za-z0-9._]{1,30}$
            description: Public Instagram username without @
        question:
          type: string
          minLength: 5
          maxLength: 600
        language:
          type: string
          enum:
          - English
          - Ελληνικά
          - Español
          - Português
          - Italiano
          - Français
          - Deutsch
          - 日本語
          - 한국어
          - العربية
        images:
          type: boolean
          enum:
          - false
          default: false
          description: Agent API v1 uses text analysis for predictable per-call cost.
      additionalProperties: false
    input_example:
      usernames:
      - instagram
      question: Summarize the recent public content signals.
      language: English
      images: false
  openapi: https://instaveil.com/api/x402/openapi
  discovery: https://instaveil.com/.well-known/x402
  human_checkout: https://instaveil.com/veilwatch