Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: AdWhiz Ads Manager Meta Ads - Audit API
description: REST API for managing Google Ads and Meta Ads accounts. All 99 tools from the AdWhiz MCP server are available as standard POST endpoints. Authenticate with your API key (Bearer aw_live_...) from https://www.adwhiz.ai/app/api-keys.
version: 1.0.0
contact:
name: AdWhiz Support
url: https://www.adwhiz.ai
email: support@adwhiz.ai
servers:
- url: https://mcp.adwhiz.ai
description: Production
tags:
- name: Meta Ads - Audit
description: Run Meta Ads account audits
paths:
/api/v1/tools/meta_run_mini_audit:
post:
operationId: meta_run_mini_audit
summary: Run a quick health audit of a Meta ad account
description: 'Run a quick health audit of a Meta ad account.
Fetches last-30-day campaign insights and computes a health score with
recommendations. Mirrors the landing page''s runMetaMiniAudit().
Args:
account_id: Meta ad account ID (e.g. ''act_12345'' or ''12345'').
Returns:
Dict with ''health_score'', ''recommendations'', ''campaigns_analyzed'',
and ''date_range''. On error: dict with ''error'' key.'
tags:
- Meta Ads - Audit
security:
- bearerApiKey: []
requestBody:
required: true
content:
application/json:
schema:
properties:
account_id:
title: Account Id
type: string
required:
- account_id
title: meta_run_mini_auditArguments
type: object
responses:
'200':
description: Tool executed successfully. Response shape depends on the tool.
content:
application/json:
schema:
type: object
'400':
description: Invalid request body
content:
application/json:
schema:
type: object
properties:
error:
type: string
'401':
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
'404':
description: Unknown tool name
content:
application/json:
schema:
type: object
properties:
error:
type: string
'429':
description: Monthly usage limit exceeded
content:
application/json:
schema:
type: object
properties:
error:
type: string
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
type: string
components:
securitySchemes:
bearerApiKey:
type: http
scheme: bearer
description: 'API key from your AdWhiz dashboard (https://www.adwhiz.ai/app/api-keys). Format: aw_live_<hex>'