Use BuzFind on a site you host yourself

If your website is hosted somewhere other than BuzFind, you can still use our 25 AI agents. It is included with every paid plan at no extra fee.

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

What this is, in plain English

BuzFind lets you point our 25 AI agents at your website. If we host your site, you use the agents through your 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.

This page shows you how. You keep your website where it is, and our agents read it and send back their reports. There is no extra fee. Your monthly plan already covers it.

Who this is for

This is for small business owners whose website is hosted somewhere else. It usually works one of two ways:

  • You have a developer or web person. You give them a key from your dashboard, and they use it to run our agents from your site or server. You do not need to be technical.
  • You are technical yourself. You set up a small piece of code that asks BuzFind to run an agent and gets the results back. The developer steps are at the bottom of this page. Either way, you start by getting 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 plan with enough agents for what 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 and save it somewhere safe right away. We can't show it to you again.
  3. Hand the key to your developer or web person. They use it to call our agents from your site or server (the steps are in the developer section below). Each agent sends back a report with the fixes to make, and your developer makes them. We can only apply fixes for you on sites we host.

That is the whole setup. For most developers it is a short job.

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

If you do not have a developer and don't want to set this up yourself, we can do it for you as a one-time job. 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 written quote. This is optional. If you have a developer, API access is already included in your plan.

Ask us to set it up for you.

What the agents will do for you

You can run any BuzFind agent from your own site or server. Here are a few:

  • Local SEO Guru checks the local signals on your own website, like your city in titles and your LocalBusiness schema, and tells you what to fix.
  • Keyword Strategist checks whether your pages use the words your customers search for and suggests which pages to write next.
  • Speed Optimizer points out what is making your site load slowly on mobile.
  • Security Sentinel checks your security settings and outside scripts for weak spots.
  • Entity Schema Engineer checks the markup that helps Google understand your business and suggests what to add.
  • E-E-A-T Content Guru reviews your pages against Google's helpful-content rules.
  • Authority Content Creator writes a first draft of an article on the topic you give it, for you to review and edit.

See the full list of all 25 agents for what each one does. Your developer can run any agent on your plan 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 somewhere else, and you do not need a separate developer plan. If your plan includes 5 agents, you can use those 5 agents on your own site at no extra charge.

The only limit is a daily cap on how many jobs each plan can run through the API. The caps are high for normal use:

  • 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

If you reach the cap, the API stops taking new jobs until the next day.

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

Your site (or your developer's code) gets a reply that says which agents are missing and which plan would include them. You can then 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 suggest one for each developer or each copy of your site (like a test site and the live one).

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 your agents on the Agents page before you call the API. Some agents run together as a team (for example, security-sentinel runs with penetration-tester), so every agent on that team must be on your plan. If one is missing, the call returns a 403 that lists the missing agents. 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 202 with a job id and a status URL right away:

{ "ok": true, "jobId": "abc123", "statusUrl": "https://buzfind.com/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 takes a few minutes. Check the status URL with the same key until the status is done (or failed):

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?