Use BuzFind on a site you host yourself

If your website lives somewhere other than BuzFind, you can still use our 25 AI agents. No extra fee - it is included with every paid plan.

By Al, BuzFind founderUpdated Portland, Indiana (Reading, PA roots)

What this is, in plain English

BuzFind lets you point our 25 AI specialists at your website. Most of our customers host their site with us and use the agents through their dashboard. But some of you already have a website hosted somewhere else, like GoDaddy, Wix, Shopify, WordPress, or a developer's server. You should not have to move your site to use BuzFind.

That is what this page covers. You can keep your website where it is and let our agents work on it from a distance. There is no extra fee. The same monthly plan you already pay covers it.

Who this is for

This is for small business owners whose website lives somewhere we do not host. Two ways this typically works:

  • You have a developer or web person. You hand them a special key from your dashboard, and they wire it into your site so the agents can do their work. You do not need to be technical.
  • You are technical yourself. You build something into your site that talks to BuzFind and gets the agents' output back. We have full developer documentation, but the start is the same: get a key from your dashboard.

If you are not technical and you do not have a developer, you can still use BuzFind. Use the dashboard like everyone else, and skip this page.

How to start (3 steps)

  1. Sign up for a paid plan. Pick the tier that includes the agents you need on the pricing page. Soloist, Squad, Department, and Empire all include this feature at no extra cost.
  2. Create your access key. Once you are signed in, go to your dashboard. Find the page called API keys in the menu. Click Create key. Give it a label so you remember which site it is for. Copy the long string of letters and numbers it shows you. Save it somewhere safe right then. We do not store it in a way we can show you again.
  3. Hand the key to your developer or web person. They paste it into your site's settings (we tell them where in our developer notes). After that, you can run audits and agents on your site from your dashboard. One-click fixing is for sites hosted with BuzFind; for a site hosted elsewhere, you get the exact steps to apply, and your developer applies them.

That is the whole setup. It usually takes a developer 10 to 15 minutes.

Don't have a developer? We can set it up for you

If you do not have a developer and you do not want to wire this up yourself, BuzFind can build the admin page and connect it to your site for you, as a one-time setup service. You keep full ownership of your site and your key, and you approve any change before it goes live. Tell us about your site and we will send you a quote. This is optional - if you have a developer, the steps above are included free with your plan.

Ask us to set it up for you.

What the agents will do for you

Every agent on BuzFind is callable from your own site. Here are some popular ones to give you a sense of what is possible:

See the full list of all 25 agents for what each one does. Whichever ones come with your plan, your developer can call them all from your site.

What does this cost?

Nothing extra. The agents are included in your monthly plan. You do not pay per call, you do not pay extra for hosting elsewhere, and you do not need a separate developer subscription. If your plan includes 7 agents, you can use those 7 agents on your own site at no additional charge.

The only fair-use limit we have is a daily cap on how many times each plan can call the agents. The cap is high enough that no honest small business will ever hit it:

  • Soloist: about 100 jobs per day
  • Squad: about 500 jobs per day
  • Department: about 2,000 jobs per day
  • Empire: about 10,000 jobs per day

For comparison, most of our customers run fewer than 30 jobs in a normal day.

What if you ask for an agent your plan does not include?

Your site (or your developer's code) gets a polite reply telling you which plan you would need. You can then decide whether to upgrade, add the missing agent on its own ($59 a month), or skip it. There is no surprise bill - we never charge you for an agent you have not chosen.

Keeping your key safe

Treat your access key like a password.

  • Do not paste the key into emails or chat messages.
  • Tell your developer to put it in a server-side environment file, not in any code that is visible in a browser.
  • If you ever think the key was leaked or stolen, log into your dashboard and click Revoke next to that key. We stop accepting it right away. Then make a new one.
  • You can have more than one key. We recommend one per developer or per environment.

For developers

Here is everything you need to call BuzFind from your own site or server. All calls use your access key in an Authorization header.

1. Get a key

The site owner creates one in the dashboard under API Keys. It looks like bf_... and is shown only once, so copy it right away. Store it in a server-side environment variable. Never put it in code that runs in the browser.

2. Pick your agents first

On the Soloist, Squad, or Department plans, choose which agents you want on the Agents page before you call the API. If you ask for an agent that is not on your plan, the call returns a 403 that tells you which plan adds it. Empire includes all of them.

3. Start a job

Send a POST request with your key in the header. Audit agents take a targetUrl:

curl -X POST https://buzfind.com/api/v1/agents/security-sentinel/run/ \
  -H "Authorization: Bearer bf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"targetUrl": "https://your-website.com"}'

You get back a job id and a status URL right away:

{ "ok": true, "jobId": "abc123", "statusUrl": "/api/v1/jobs/abc123/" }

Content agents (like authority-content-creator) take a topic and a contentType instead of a targetUrl.

4. Get the result

The job runs for a few minutes. Poll the status URL with the same key until it says done:

curl https://buzfind.com/api/v1/jobs/abc123/ \
  -H "Authorization: Bearer bf_your_key_here"

In JavaScript or Next.js

Run this on the server (an API route or a server action), never in the browser:

const res = await fetch("https://buzfind.com/api/v1/agents/security-sentinel/run/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.BUZFIND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ targetUrl: "https://your-website.com" }),
})
const { jobId } = await res.json()
// then poll GET /api/v1/jobs/<jobId>/ until its status is "done"

Agent names in the URL match your dashboard agents - for example security-sentinel, speed-optimizer, or local-seo-guru. Daily limits depend on your plan (see above). A 429 means you hit today's cap, and a 402 means there is no active plan on the account.

Next steps

Was this article helpful?
BuzFind API: Run AI Agents on Your Own Site