https://1325.ai/assets/SupplierApiDocsPage-DebFdTyZ.js

1import{j as e}from"./ui-vendor-CEJ8_wX2.js";import{w as s,H as t,v as i,c as a}from"./index-BiVZYF0p.js";import{D as n}from"./database-BDeMyeXz.js";import{L as r}from"./react-vendor-DWXAA69x.js";import"./supabase-BPE9t49R.js";import"./admin-heavy-CCv53o_I.js";import"./charts-CkMHw2ev.js";import"./animation-B0AhmLf0.js";import"./query-vendor-e1oLGoso.js";
2/**
3 * @license lucide-react v0.462.0 - ISC
4 *
5 * This source code is licensed under the ISC license.
6 * See the LICENSE file in the root directory of this source tree.
7 */const l=s("KeyRound",[["path",{d:"M2.586 17.414A2 2 0 0 0 2 18.828V21a1 1 0 0 0 1 1h3a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h1a1 1 0 0 0 1-1v-1a1 1 0 0 1 1-1h.172a2 2 0 0 0 1.414-.586l.814-.814a6.5 6.5 0 1 0-4-4z",key:"1s6t7t"}],["circle",{cx:"16.5",cy:"7.5",r:".5",fill:"currentColor",key:"w0ekpg"}]]),o="https://agoclnqfyinwjxdmjnns.supabase.co/functions/v1/supplier-search",d=[{name:"query",type:"text",description:'Keyword matched against business name, category, and description. Example: "security", "catering", "IT services".'},{name:"category",type:"text",description:'Exact category name as listed in the directory. Example: "Barbershop".'},{name:"city",type:"text",description:'City name. Example: "Atlanta".'},{name:"state",type:"text",description:'Two-letter state code. Example: "GA".'},{name:"zip",type:"text",description:"Five-digit ZIP code. Used as the center point for radius search."},{name:"radius_miles",type:"number",description:"Search radius around the ZIP code, from 1 to 250 miles. Defaults to 25. Ignored when no ZIP is supplied."},{name:"verified_only",type:"true / false",description:"When true, returns only businesses that have completed 1325.AI verification."},{name:"limit",type:"number",description:"Results per request, maximum 100. Defaults to 25."},{name:"offset",type:"number",description:"Number of results to skip, for paging through large result sets."}],c=[{name:"id",description:"Stable unique identifier for the business. Use this as your foreign key."},{name:"name",description:"Legal or trading name of the business."},{name:"description",description:"Short public summary of what the business does."},{name:"category",description:"Primary business category."},{name:"city / state / zip_code",description:"Public business location."},{name:"phone",description:"Public business phone number, when published."},{name:"website",description:"Public business website, when published."},{name:"verified",description:"True when the business has completed 1325.AI listing verification."},{name:"ownership_verified",description:"True when Black ownership has been confirmed at high confidence and carries no open review flag."},{name:"average_rating / review_count",description:"Public community rating information."},{name:"distance_miles",description:"Distance from the supplied ZIP code. Null when no ZIP was supplied."},{name:"listing_url",description:"Public 1325.ai profile page for the business."}],m=[{code:"MISSING_API_KEY",status:"401",meaning:"No key was sent. Add the Authorization or X-API-Key header."},{code:"INVALID_API_KEY",status:"401",meaning:"The key is wrong, revoked, or the account is not active."},{code:"FORBIDDEN_SCOPE",status:"403",meaning:"The key is valid but is not permitted to use supplier search."},{code:"RATE_LIMITED",status:"429",meaning:"Too many requests this minute. Wait and retry."},{code:"SEARCH_ERROR",status:"500",meaning:"Unexpected error on our side. Contact [email protected] with the time of the request."}],h=`curl -G "${o}" \\\n  -H "X-API-Key: YOUR_API_KEY" \\\n  --data-urlencode "query=security" \\\n  --data-urlencode "state=GA" \\\n  --data-urlencode "verified_only=true" \\\n  --data-urlencode "limit=25"`,x=`curl -G "${o}" \\\n  -H "X-API-Key: YOUR_API_KEY" \\\n  --data-urlencode "zip=30303" \\\n  --data-urlencode "radius_miles=15" \\\n  --data-urlencode "category=Catering"`,p=({children:s,label:t})=>e.jsxs("div",{className:"rounded-xl border border-white/10 bg-black/50 overflow-hidden",children:[t&&e.jsx("div",{className:"px-4 py-2 border-b border-white/10 text-xs uppercase tracking-wider text-white/40",children:t}),e.jsx("pre",{className:"p-4 overflow-x-auto text-xs md:text-sm font-mono text-white whitespace-pre",children:s})]}),u=()=>e.jsxs("div",{className:"min-h-screen bg-gradient-to-br from-black via-[#050a18] to-[#030712] text-white",children:[e.jsxs(t,{children:[e.jsx("title",{children:"Supplier Search API Documentation | 1325.AI"}),e.jsx("meta",{name:"description",content:"Partner documentation for the 1325.AI Supplier Search API: endpoint, authentication, search f

7ilters, response fields, rate limits, and support contact."}),e.jsx("link",{rel:"canonical",href:"https://www.1325.ai/supplier-api"})]}),e.jsxs("main",{className:"max-w-4xl mx-auto px-4 py-12 md:py-16",children:[e.jsxs("div",{className:"flex items-center gap-2 text-mansagold mb-3",children:[e.jsx(i,{className:"w-5 h-5","aria-hidden":!0}),e.jsx("span",{className:"text-sm font-semibold uppercase tracking-wider",children:"Partner Documentation"})]}),e.jsx("h1",{className:"text-3xl md:text-4xl font-bold mb-3",children:"1325.AI Supplier Search API"}),e.jsx("p",{className:"text-white md:text-lg mb-10",children:"The Supplier Search API gives approved partners programmatic access to the 1325.AI directory of verified Black-owned businesses across the United States. Use it to power supplier-diversity sourcing, vendor discovery, procurement portals, and internal CRM enrichment. The API is read-only and returns only public listing information."}),e.jsxs("section",{className:"rounded-2xl border border-white/10 bg-white/5 p-5 md:p-6 mb-10",children:[e.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[e.jsx(n,{className:"w-5 h-5 text-mansagold","aria-hidden":!0}),e.jsx("h2",{className:"text-xl font-semibold",children:"Endpoint"})]}),e.jsxs("dl",{className:"space-y-3 text-sm",children:[e.jsxs("div",{children:[e.jsx("dt",{className:"text-white/80",children:"URL"}),e.jsx("dd",{className:"font-mono text-mansagold break-all",children:o})]}),e.jsxs("div",{children:[e.jsx("dt",{className:"text-white/80",children:"Methods"}),e.jsxs("dd",{children:[e.jsx("span",{className:"font-mono",children:"GET"})," with query parameters, or"," ",e.jsx("span",{className:"font-mono",children:"POST"})," with a JSON body. Both accept the same parameters."]})]}),e.jsxs("div",{children:[e.jsx("dt",{className:"text-white/80",children:"Format"}),e.jsx("dd",{children:"JSON request and response, UTF-8."})]})]})]}),e.jsxs("section",{className:"rounded-2xl border border-white/10 bg-white/5 p-5 md:p-6 mb-10",children:[e.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[e.jsx(l,{className:"w-5 h-5 text-mansagold","aria-hidden":!0}),e.jsx("h2",{className:"text-xl font-semibold",children:"Authentication"})]}),e.jsx("p",{className:"text-white text-sm mb-4",children:"Every request requires the API key issued to your organization by 1325.AI. Send it in either header:"}),e.jsx(p,{children:"X-API-Key: YOUR_API_KEY\n# or\nAuthorization: Bearer YOUR_API_KEY"}),e.jsxs("p",{className:"text-white/80 text-sm mt-4",children:["Keys are shown once at the time of issue and are stored by 1325.AI only in hashed form. Treat the key as a password: keep it on your server, never in browser or mobile code. To rotate or revoke a key, email"," ",e.jsx("a",{href:"mailto:[email protected]",className:"text-mansagold hover:underline",children:"[email protected]"}),"."]})]}),e.jsxs("section",{className:"mb-10",children:[e.jsx("h2",{className:"text-xl font-semibold mb-4",children:"Search parameters"}),e.jsx("p",{className:"text-white/90 text-sm mb-4",children:"All parameters are optional. Sending none returns the newest live listings. Filters combine with each other, so city plus category narrows the result set."}),e.jsx("div",{className:"rounded-2xl border border-white/10 overflow-hidden",children:e.jsxs("table",{className:"w-full text-sm",children:[e.jsx("thead",{className:"bg-white/5",children:e.jsxs("tr",{children:[e.jsx("th",{className:"text-left px-4 py-3 font-semibold",children:"Parameter"}),e.jsx("th",{className:"text-left px-4 py-3 font-semibold hidden sm:table-cell",children:"Type"}),e.jsx("th",{className:"text-left px-4 py-3 font-semibold",children:"Description"})]})}),e.jsx("tbody",{children:d.map(s=>e.jsxs("tr",{className:"border-t border-white/10 align-top",children:[e.jsx("td",{className:"px-4 py-3 font-mono text-mansagold whitespace-nowrap",children:s.name}),e.jsx("td",{className:"px-4 py-3 text-white/80 hidden sm:table-cell whitespace-nowrap",children:s.type}),e.jsx("td",{className:"px-4 py-3 text-white",children:s.description})]},s.name))})]})})]}),e.jsxs("section",{className:"mb-10 space-y-4",children:[e.jsx("h2",{className:"text-xl font-semibold",children:"Example requests"}),e.jsx(p,{label:"Keyword and state",children:h}),e.jsx(p,{label:"ZIP code and radius",children:x})]}),e.jsxs("section",{className:"mb-10",children:[e.jsx("h2",{className:"text-xl font-semibold mb-4",children:"Example response"}),e.jsx(p,{label:"200 OK",children:'{\n  "success": true,\n  "total": 129,\n  "count": 1,\n  "limit": 25,\n  "offset": 0,\n  "results": [\n    {\n      "id": "acefb6ec-6e41-4de2-9158-1d6a7b9c79b5",\n      "name": "CJM Security Consultants",\n      "description": "Atlanta-headquartered security firm ...",\n      "category": "Security Consulting & Guard Services",\n      "city": "Atlanta",\n      "state": "GA",\n      "zip_code": "30301",\n      "phone": null,\n      "website": "https://cjmsecurity.com",\n      "verified": true,\n      "ownership_verified": true,\n      "average_rating": 0,\n      "review_count": 0,\n      "distance_miles": 0.15,\n      "listing_url": "https://1325.ai/business/cjm-security-consultants-atlanta-acefb6"\n    }\n  ],\n  "source": "1325.AI verified Black-owned business directory"\n}'}),e.jsxs("p",{className:"text-white/80 text-sm mt-4",children:[e.jsx("span",{className:"font-mono text-white",children:"total"})," is the number of businesses matching your filters;"," ",e.jsx("span",{className:"font-mono text-white",children:"count"})," is the number returned in this response. Page through larger result sets by increasing ",e.jsx("span",{className:"font-mono text-white",children:"offset"}),"."]})]}),e.jsxs("section",{className:"mb-10",children:[e.jsx("h2",{className:"text-xl font-semibold mb-4",children:"Response fields"}),e.jsx("div",{className:"rounded-2xl border border-white/10 overflow-hidden",children:e.jsxs("table",{className:"w-full text-sm",children:[e.jsx("thead",{className:"bg-white/5",children:e.jsxs("tr",{children:[e.jsx("th",{className:"text-left px-4 py-3 font-semibold",children:"Field"}),e.jsx("th",{className:"text-left px-4 py-3 font-semibold",children:"Meaning"})]})}),e.jsx("tbody",{children:c.map(s=>e.jsxs("tr",{className:"border-t border-white/10 align-top",children:[e.jsx("td",{className:"px-4 py-3 font-mono text-mansagold whitespace-nowrap",children:s.name}),e.jsx("td",{className:"px-4 py-3 text-white",children:s.description})]},s.name))})]})})]}),e.jsxs("section",{className:"mb-10",children:[e.jsx("h2",{className:"text-xl font-semibold mb-4",children:"Errors"}),e.jsx("div",{className:"rounded-2xl border border-white/10 overflow-hidden",children:e.jsxs("table",{className:"w-full text-sm",children:[e.jsx("thead",{className:"bg-white/5",children:e.jsxs("tr",{children:[e.jsx("th",{className:"text-left px-4 py-3 font-semibold",children:"Code"}),e.jsx("th",{className:"text-left px-4 py-3 font-semibold hidden sm:table-cell",children:"HTTP"}),e.jsx("th",{className:"text-left px-4 py-3 font-semibold",children:"What it means"})]})}),e.jsx("tbody",{children:m.map(s=>e.jsxs("tr",{className:"border-t border-white/10 align-top",children:[e.jsx("td",{className:"px-4 py-3 font-mono text-mansagold whitespace-nowrap",children:s.code}),e.jsx("td",{className:"px-4 py-3 text-white/80 hidden sm:table-cell",children:s.status}),e.jsx("td",{className:"px-4 py-3 text-white",children:s.meaning})]},s.code))})]})})]}),e.jsxs("section",{className:"rounded-2xl border border-white/10 bg-white/5 p-5 md:p-6 mb-10",children:[e.jsxs("div",{className:"flex items-center gap-2 mb-3",children:[e.jsx(a,{className:"w-5 h-5 text-mansagold","aria-hidden":!0}),e.jsx("h2",{className:"text-xl font-semibold",children:"Data handling and limits"})]}),e.jsxs("ul",{className:"list-disc pl-5 space-y-2 text-white text-sm",children:[e.jsx("li",{children:"The API is read-only. It cannot create, change, or delete any record in the 1325.AI platform."}),e.jsx("li",{children:"Only public listing information is returned. Owner email addresses, account records, financial data, and internal notes are never exposed."}),e.jsx("li",{children:"A maximum of 100 businesses is returned per request, with per-minute rate limits applied to each key."}

7),e.jsx("li",{children:"Every successful call is logged for usage reporting and billing."}),e.jsx("li",{children:"Listings are refreshed continuously; cache results no longer than 24 hours so your users see current data."})]})]}),e.jsxs("section",{className:"rounded-2xl border border-white/10 bg-white/5 p-5 md:p-6",children:[e.jsx("h2",{className:"text-xl font-semibold mb-3",children:"Access and support"}),e.jsxs("p",{className:"text-white text-sm",children:["To request an API key or discuss volume, integration, or procurement requirements, contact"," ",e.jsx("a",{href:"mailto:[email protected]",className:"text-mansagold hover:underline",children:"[email protected]"}),". For AI assistant access to the same directory, see the"," ",e.jsx(r,{to:"/connect/docs",className:"text-mansagold hover:underline",children:"1325.AI MCP connector documentation"}),"."]}),e.jsx("p",{className:"text-white/40 text-xs mt-4",children:"Protected under U.S. Provisional Patent Application No. 63/969,202 — 46 claims pending."})]})]})]});export{u as default};