# Airbrush Insights API > Derived social video insights as JSON and as MCP tools: breakout videos (outliers), trends, long-running ads, shop products with evidence, creator stats, full research reports and view predictions. Every answer carries its sources, a confidence score and the list of estimated fields. Every Airbrush plan includes the API. Each month you get as many API credits as your plan's monthly credits, renewed on the 1st. A cached answer costs 1 credit, polling a job is free, and a call that fails gives its credits back. ## Auth - Create a key on https://app.airbrush.ai/x/api/insights/usage. It starts with mxk_ and is shown once. - Send it as Authorization: Bearer mxk_... (or the X-API-Key header). Never in the query string. - Add Idempotency-Key to a POST and a retry is never charged twice. - Too many requests in a short time answer 429 with a Retry-After header. ## Endpoints (base https://api.airbrush.ai/v1) - GET /v1/outliers: Breakout videos for a keyword, scored against the creator or niche median (10 credits, cached 1 credit; instant) - GET /v1/trends: Hooks, formats, hashtags and sounds that are emerging, peaking or cooling (2 credits; instant) - GET /v1/ads: Long-running ads for a keyword or brand, ranked by run length, placements and versions (6 credits, cached 1 credit; cached or a job) - GET /v1/products: Shop listings with evidence: est. 7-day units, saturation and look-alikes (15 credits, cached 1 credit; cached or a job) - GET /v1/creators/{platform}/{handle}: Median views, posting cadence, breakouts and best recent posts of one creator (3 credits, cached 1 credit; cached or a job) - POST /v1/research: A full report: insights, top outliers, hooks, formats and rising searches (32 credits, cached 1 credit; cached or a job) - POST /v1/predict: A likely views range for a post link or a script, with 3 to 5 fixes (10 credits; a job) - GET /v1/jobs/{id}: The status of a job, then its result (free; instant) - GET /v1/reports/{id}: A report from one of your own research runs, read again (free; instant) - GET /v1/insights/{id}: One insight card from your own reports (free; instant) - GET /v1/openapi.json: the OpenAPI 3.1 description of every endpoint (free) Every answer is { ok, data, meta }. meta.credits has charged and balance. Errors are { ok: false, error: { code, message } } with codes such as BAD_INPUT, AUTH_REQUIRED, NO_CREDITS, NOT_FOUND, SLOW_DOWN, UPSTREAM_5XX, TIMEOUT and KILLED. Longer runs answer 202 with { id, status, poll }. Poll GET /v1/jobs/{id} until status is done (or failed), or set a webhook on the key: job.completed and job.failed, signed with Airbrush-Signature: t=,v1=. ## MCP (AI assistants) - Remote MCP server (Streamable HTTP, JSON answers): https://api.airbrush.ai/v1/mcp with the same Bearer key, billed like the REST calls. - Tools: run_research, get_report, get_insight, search_outliers, get_trends, search_ads, search_products, lookup_creator, predict_views, get_job. ## Links - [Docs and quick start](https://app.airbrush.ai/x/api/insights) - [OpenAPI 3.1 spec](https://api.airbrush.ai/openapi.json): free, no key needed ## Image generation - POST https://api.airbrush.ai/v1/images with JSON { api_key, content, ai_engine, image_dimensions }. The key can also go in Authorization: Bearer. Answers { success, data: { image_url, credits_used, credits_remaining } }. - Uses your image API key from https://app.airbrush.ai/x/account/api (not the mxk_ key). Existing integrations on app.airbrush.ai keep working. - [Keys and usage](https://app.airbrush.ai/x/api/insights/usage)