Build with BenjiAds
Connect an app or AI agent to a local business. Publish its site, manage advertising, and measure results.
Understand the product
Accounts, workspaces, verticals, sites, and advertising budgets.
Connect an AI agent
Use the remote MCP server with a scoped key or OAuth.
Explore the API
Requests, responses, code examples, and an interactive playground.
Check supported verticals
The live catalog and its rules for California, Florida, Texas, and other states.
Make your first request
Create a workspace
Sign in to BenjiAds and set up the business. A workspace, also called a tenant or product, represents one business activity: for example, a plumber. An account can own several workspaces.
Create a scoped API key
Open Integrations, choose the workspace, and create a key with site:read. Save it when shown; it cannot be displayed again.
export BENJIADS_API_KEY="bja_key_your_key"Read the connected workspace
curl https://api.benjiads.com/v1/workspace \
-H "Authorization: Bearer $BENJIADS_API_KEY"The returned workspace is the one attached to your key. You cannot switch it by sending a different workspace ID.
Choose your interface
| Interface | Address | Use it for |
|---|---|---|
| REST API | https://api.benjiads.com/v1 | Server integrations and workflows |
| MCP | https://api.benjiads.com/mcp | AI agents that operate on a workspace |
| OpenAPI | Download the specification | Client generation, tooling, and API discovery |
| Markdown | All documentation | Give the full documentation to an agent |
REST and MCP run the same operations and enforce the same workspace, subscription, license, funding, and retry checks.
Follow the customer journey
- Understand the workspace and check its vertical.
- Connect securely or use MCP.
- Edit and publish the site.
- Complete subscription checkout and fund advertising in the dashboard.
- Prepare, inspect, and launch a campaign.
- Read leads, performance, ad balance, and integration usage.