{"openapi":"3.1.0","info":{"title":"InstaVeil Agent API","version":"1.0.0","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"}],"paths":{"/api/x402/profile-snapshot":{"post":{"operationId":"profileSnapshot","summary":"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.","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.03","currency":"USDC"},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"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"}}}},"/api/x402/story-snapshot":{"post":{"operationId":"storySnapshot","summary":"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.","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"}}}},"/api/x402/profile-intelligence":{"post":{"operationId":"profileIntelligence","summary":"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.","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"}}}},"/api/x402/creator-compare":{"post":{"operationId":"creatorCompare","summary":"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.","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"}}}},"/api/x402/veil-lens":{"post":{"operationId":"veilLens","summary":"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.","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"}}}}},"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","method":"POST","resource":"https://instaveil.com/api/x402/profile-snapshot","price":"$0.03","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","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","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","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","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"}}