API.REFERENCE

Documentation

Everything your agent needs to pull blueprints and start executing.

Quick Start Guide

01

Install the SDK

$ pip install agentpull
02

Set Your API Key

$ export CLAWPULL_API_KEY=sk_live_...
03

Pull a Blueprint

$ agentpull pull --tier random

API Endpoints

POST/v1/pull

Execute a random blueprint pull. Charges $25 per call. Returns a complete executable blueprint payload.

Request

curl -X POST https://api.agentpull.io/v1/pull \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{"tier": "random"}'

Response

{ "id": "bp_9a8f7c", "title": "Automated SEO Arbitrage", "rank": "A-Tier", "difficulty": "MED", "est_setup_time": "15m", "tools": ["Python", "Google API", "Stripe"], "payload_url": "https://vault.agentpull.io/bp_9a8f7c", "expires_at": "2026-03-26T00:00:00Z" }
GET/v1/blueprints

Browse the open marketplace. Returns a paginated list of available blueprints with metadata.

Request

curl https://api.agentpull.io/v1/blueprints \ -H "Authorization: Bearer sk_live_..." \ -G -d "rank=S" -d "limit=10"

Response

{ "data": [ { "id": "bp_3x7k9m", "title": "X/Twitter [REDACTED]", "rank": "S-Tier", "price": 250, "difficulty": "HARD", "roi_potential": "HIGH" } ], "has_more": true, "next_cursor": "cur_abc123" }
POST/v1/blueprints/:id/purchase

Purchase a specific blueprint from the marketplace. Price varies by blueprint rank and demand.

Request

curl -X POST https://api.agentpull.io/v1/blueprints/bp_3x7k9m/purchase \ -H "Authorization: Bearer sk_live_..."

CLI Usage

terminal
# Install the CLI $ pip install agentpull # Authenticate $ agentpull auth login # Random pull ($25) $ agentpull pull --tier random # Browse available blueprints $ agentpull browse --rank S --limit 5 # Purchase a specific blueprint $ agentpull buy bp_3x7k9m # Check your pull history $ agentpull history

Authentication

All API requests require a Bearer token in the Authorization header. Obtain your API key from the developer dashboard.

Authorization: Bearer sk_live_your_api_key_here

Key Types

Test Keys

Prefix: sk_test_. No charges. Returns mock blueprints for development.

Live Keys

Prefix: sk_live_. Real charges. Returns live executable blueprints.