# Adspirer REST API

> REST endpoints for every Adspirer tool — create, manage, and analyze ad campaigns on Google Ads, Meta, LinkedIn, and TikTok from any HTTP client.
> 178 tools. Same surface as the MCP server, plain HTTP request/response.

Designed for n8n, Zapier, Make, Python, Node.js, curl, and any language with an HTTP library.

## Getting started

- [API reference (full)](https://api.adspirer.ai/reference/)
- [OpenAPI 3.1 spec (JSON)](https://api.adspirer.ai/openapi.json)
- [Swagger UI (interactive)](https://api.adspirer.ai/docs/)
- [Full inline reference for LLMs](https://api.adspirer.ai/llms-full.txt)

## Authentication

Bearer token in `Authorization: Bearer sk_live_...`. Get a key at [adspirer.ai/keys](https://adspirer.ai/keys).

## Request shape

```
POST https://api.adspirer.ai/api/v1/tools/<tool_name>/execute
Authorization: Bearer sk_live_...
Content-Type: application/json
Idempotency-Key: <uuid>   (optional but recommended for writes)

{"arguments": {...tool-specific fields...}}
```

## Response shape

Success:
```
{"success": true, "data": {"text": "...", "quota": {...}}, "tool": "..."}
```

Error:
```
{"success": false, "error": "human-readable message", "is_error": true, "tool": "..."}
```

## Tools by platform

- [Audit (1 tools)](https://api.adspirer.ai/reference/#audit)
- [General (Account Management) (3 tools)](https://api.adspirer.ai/reference/#general)
- [Google Ads (51 tools)](https://api.adspirer.ai/reference/#google-ads)
- [LinkedIn Ads (45 tools)](https://api.adspirer.ai/reference/#linkedin-ads)
- [Meta Ads (36 tools)](https://api.adspirer.ai/reference/#meta-ads)
- [Monitoring & Reporting (13 tools)](https://api.adspirer.ai/reference/#monitoring)
- [TikTok Ads (29 tools)](https://api.adspirer.ai/reference/#tiktok-ads)

## Optional

- [robots.txt](https://api.adspirer.ai/robots.txt)
- [sitemap.xml](https://api.adspirer.ai/sitemap.xml)