{"uid":"cap_Jm9YTdcAj4kXDhxhVX7Jv","slug":"adprompt-competitive-analysis-api-49700b36","name":"AdPrompt Competitive Analysis API","description":"Public x402 API for the full AdPrompt engine and bundle catalog. Paid endpoints return an x402 v2 402 challenge until a valid payment is supplied.","url":"https://x402.adprompt.io/v1/competitive-analysis","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"website":{"type":"string","description":"If no profile is available, this adds a required paid Brand Scan."},"profile_id":{"type":"string"},"save_profile":{"type":"boolean"},"wallet_address":{"type":"string"},"manual_business_profile":{"type":"object"}}},"responseSchema":{"type":"object","required":["ok","status","product_id","receipt_id","request_id","result_url","report_url"],"properties":{"ok":{"type":"boolean","const":true},"label":{"type":"string"},"job_id":{"type":"string","description":"Present only for the asynchronous video product."},"status":{"type":"string","const":"queued"},"product_id":{"type":"string"},"receipt_id":{"type":"string"},"report_url":{"type":"string","description":"Fetch this once background processing completes for the full AdPrompt-branded report."},"request_id":{"type":"string"},"result_url":{"type":"string","const":"/results"},"polling_url":{"type":"string","description":"Present only for the asynchronous video product."},"saved_profile":{"type":"object","properties":{"name":{"type":"string"},"website":{"type":"string","format":"uri"},"profile_id":{"type":"string"}},"additionalProperties":true},"business_context":{"type":"object"},"adprompt_signature":{"type":"object"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xqjnr1BRXghpeFtgp_fS6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs an AI-powered competitive analysis for a business, returning strategic insights about competitors, market positioning, and brand landscape via x402 micropayment-gated endpoint.","exampleAgentPrompt":"Run a competitive analysis for my business at acmeshoes.com — save the profile so I don't need to re-scan — and tell me who my main competitors are and how we compare.","exampleUseCases":[{"title":"Startup competitive landscape discovery","prompt":"I just launched a SaaS project management tool at planflow.io — can you run a competitive analysis on it and tell me who the top competitors are and how we're positioned differently?"},{"title":"E-commerce brand benchmarking","prompt":"Can you do a competitive analysis for my online store at verdantbotanicals.com and save my profile? I want to know which brands I'm competing against and where I stand in the market."},{"title":"Agency client pitch research","prompt":"I'm pitching a new client in the fitness equipment space — their site is ironpeak-fitness.com. Run a competitive analysis using their profile so I can walk into the meeting knowing their competitive landscape."}],"resultDescription":"Returns a JSON object containing the competitive analysis result (competitor names, positioning insights, market landscape), business context metadata, creative metadata, a receipt ID confirming the x402 micropayment, a product ID, the price paid in USD, and optionally a saved profile object with profile_id, name, and website for future reuse.","failureModes":["402 Payment Required — no valid x402 payment header supplied; endpoint returns a challenge until payment is provided","Missing required input — neither website nor profile_id nor manual_business_profile provided, resulting in a validation error","Website scan failure — if the provided URL is unreachable or returns no meaningful content, the brand scan step may fail","Invalid wallet address — malformed wallet address may cause payment or receipt processing errors","Rate limiting or upstream AI failure — competitive analysis generation may time out or return an error if the AI backend is overloaded"],"whenToPreferThis":"Choose this endpoint when you need structured, AI-generated competitive intelligence for a specific business and are operating in an x402 micropayment-capable environment. It is ideal for agents that already have a business profile_id stored from a prior AdPrompt scan, or can provide a website URL for a fresh brand scan. Prefer this over generic web search when you need a pre-formatted, structured JSON competitive analysis bundle ready for downstream agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:35.472Z","isFirstParty":false}