BBuildly
Home/API Reference

API Reference

Run any Buildly tool programmatically from your own application. One endpoint, one key, any tool.

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys in Settings → API Keys.

Authorization: Bearer bld_your_key_here

Run a tool

POST/api/v1/tools/{slug}/run

Replace {slug}with the tool's URL slug, visible in the tool's URL on Buildly.

Request body

Send a JSON body with an inputobject. The keys match each tool's input field keys, visible on the tool's page.

{
  "input": {
    "field_key": "value",
    "another_field": "value"
  }
}

Response

A successful response returns HTTP 200 with a resultobject. Keys match the tool's output fields.

{
  "result": {
    "output_key": "Generated content here..."
  }
}

Full example

curl -X POST https://buildly.click/api/v1/tools/eli5/run \
  -H "Authorization: Bearer bld_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"input": {"topic": "How does DNS work?"}}'

Error codes

400

Bad Request

Missing or invalid input fields.

401

Unauthorized

Missing or invalid API key.

403

Forbidden

Tool requires Pro plan or a paid purchase.

404

Not Found

No tool with that slug exists.

429

Rate Limited

Daily API key limit reached. Resets at midnight UTC.

500

Server Error

Tool execution failed. Retry with exponential backoff.

Rate limits

Free20 requests / day per API key
Pro500 requests / day per API key

Limits reset daily at midnight UTC. Upgrade in Settings → Plan.

Ready to build?

Get your API key