API · Lookup

Discover businesses & offerings

Filter the directory by category, goal, or property. All endpoints return paginated, structured JSON.

Endpoints

GET/v1/businesses?category=&property=List businesses

GET/v1/businesses/{id}Single business

GET/v1/offerings?purpose=&property=&max_price=Search offerings

GET/v1/offerings/{id}Single offering

List businesses

Filter by category, property, or free-text q. Results return in deterministic order by rating desc.

curl "https://api.atomic.dev/v1/businesses?category=Printing&property=DTG" \
  -H "Authorization: Bearer atk_live_••••••••"

{
  "data": [
    {
      "id": "biz_blankcanvas",
      "name": "BlankCanvas Apparel",
      "category": "Apparel · Blanks",
      "city": "Los Angeles",
      "state": "CA",
      "rating": 4.8,
      "review_count": 1247,
      "properties": [
        "wholesale",
        "low-MOQ",
        "fast-ship",
        "ringspun-cotton"
      ]
    }
  ],
  "meta": {
    "request_id": "req_01HZX",
    "latency_us": 412,
    "served_by": "edge-sjc-3"
  }
}

Search offerings by goal

The purpose filter is the agent-native way to search: pass the high-level goal you're trying to achieve.

const res = await atomic.offerings.search({
  purpose: "t-shirt-printing",
  property: ["wholesale", "low-MOQ"],
  max_price: 6.0,
  unit: "unit",
});
"c">// res.data is sorted by relevance, then by price asc

Single offering

Returns the full spec, SLA, warranty, and pricing. Stable across requests until the vendor publishes a new revision.

{
  "id": "off_bc_tee_unisex",
  "businessId": "biz_blankcanvas",
  "name": "Unisex Ringspun Tee — Blank",
  "kind": "product",
  "category": "Apparel · Blanks",
  "price": {
    "amount": 4.25,
    "currency": "USD",
    "unit": "unit"
  },
  "description": "100% ringspun cotton, 5.3 oz. Pre-shrunk. Available in XS–4XL across 14 colors.",
  "specifications": {
    "material": "100% ringspun cotton",
    "weight_oz": 5.3,
    "sizes": [
      "XS",
      "S",
      "M",
      "L",
      "XL",
      "2XL",
      "3XL",
      "4XL"
    ],
    "colors": 14,
    "moq": 25
  },
  "purpose": [
    "t-shirt-printing",
    "merchandise",
    "uniforms"
  ],
  "properties": [
    "soft",
    "pre-shrunk",
    "low-MOQ",
    "wholesale"
  ],
  "sla": {
    "leadTimeHours": 24,
    "notes": "Same-day pick on orders before 11am PT."
  },
  "warranty": {
    "durationDays": 30,
    "terms": "Defects refunded or replaced within 30 days."
  }
}