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 scoped API key
Sign in to BenjiAds with your phone number; a new number creates the account. Open Integrations and create a key. By default it covers all your businesses, including ones you create later; you can pin it to a single business instead. Save it when shown; it cannot be displayed again.
export BENJIADS_API_KEY="bja_key_your_key"List your businesses, or set one up
curl https://api.benjiads.com/v1/businesses \
-H "Authorization: Bearer $BENJIADS_API_KEY"No business yet? One call sets it up: the site goes live and the ads are prepared, paused. It is free.
curl https://api.benjiads.com/v1/businesses \
-H "Authorization: Bearer $BENJIADS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: setup-mikes-electric" \
-d '{"name":"Mike'"'"'s Electric","trade":"electrician","cities":["Long Beach, CA"]}'A business (also called a workspace or tenant) is one business activity: for example, a plumber. An account can own several. With more than one, name the business with the x-workspace header; BenjiAds never picks one for you.
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 set up and run a business |
| 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 business, license, funding, and retry checks.
Follow the customer journey
BenjiAds is free. No subscription, no credit card. You only pay for your ads.
- Connect securely or use MCP.
- Understand businesses and check the trade.
- Set up the business with
setup_business: site live, ads prepared. - Edit and publish the site whenever you like.
- Launch the ads at an agreed daily budget, and add money for ads in the browser.
- Read the overview, leads, performance, and integration usage.