Seller API Reference
A small REST API for connecting your own tools to your ScriptBull store — read your listings, check a single product, or confirm an order number without logging into the dashboard.
Overview
Every endpoint below returns JSON and lives under /api/v1/. Requests are read-only (GET) except where noted, and every request must include your API key.
Available endpoints
- GET
/api/v1/profile.php— your store profile - GET
/api/v1/listings.php— all of your active listings - GET
/api/v1/listing.php— one listing's full detail - GET
/api/v1/order.php— verify an order number
Getting Your Key
API keys are generated per seller and never expire until you regenerate them.
- Open Seller SettingsSign in and go to Seller Dashboard → Settings.
- Find the Seller API cardIt sits next to your store profile, on the right.
- Click Create API KeyA key starting with
sk_live_appears instantly. - Copy it somewhere safeUse the copy icon next to the key field.
- Send it with every requestEither as an
Authorization: Bearer <key>header, or anapi_keyquery parameter.
curl -H "Authorization: Bearer sk_live_yourkeyhere" \ https://scriptbull.com/api/v1/profile.php
Lost or exposed a key? Regenerate it from the same card — the old one stops working the moment you do.
Store Profile
Returns your store's public profile plus a couple of account-level stats.
{
"status": "success",
"data": {
"id": 14,
"name": "Jane Seller",
"email": "jane@example.com",
"store_url": "https://yoursite.com/seller/jane-seller-14",
"bio": "I build clean, documented PHP tools.",
"listing_count": 6,
"total_sales": 214,
"member_since": "2025-03-11 10:02:00"
}
}
All Listings
Every active product you have published, newest first.
{
"status": "success",
"listings": [
{
"id": 101,
"title": "Invoice Manager Pro",
"url": "https://yoursite.com/item/invoice-manager-pro-101",
"category": "PHP Scripts",
"price": { "regular": 29.00, "extended": 89.00, "discount_percent": 0 },
"currency": "USD",
"sales": 42,
"rating": 4.8
}
]
}
Single Listing
id— the listing's numeric ID required
Full detail for one of your own listings, including screenshots and feature list. Returns an error if the ID isn't yours.
Verify Order
order_number— e.g.DM-D452E590-18required
Confirms an order belongs to one of your products before you grant a buyer access to a license, support, or an update.
{
"status": "success",
"data": {
"order": {
"order_number": "DM-D452E590-18",
"status": "completed",
"license": "regular",
"amount": 29.00,
"product": { "id": 101, "title": "Invoice Manager Pro" },
"buyer_name": "Alex Buyer",
"purchased_at": "2026-08-10 14:22:03"
}
}
}