{"name":"RAWMATE Supplier Discovery API","version":"1.0.0","description":"Free public APIs for AI agents to discover and source suppliers globally","homepage":"https://www.rawmatecustom.com","documentation":"https://www.rawmatecustom.com/api","apis":[{"name":"Semantic Search","endpoint":"https://www.rawmatecustom.com/api/suppliers/semantic","method":"POST","description":"Search suppliers using natural language queries with vector embeddings for semantic matching","use_case":"Best for natural language queries like 'I need premium hotel soaps in Kerala'","rate_limit":"100 requests/minute per IP","authentication":"None (public)"},{"name":"Keyword Search","endpoint":"https://www.rawmatecustom.com/api/suppliers","method":"GET","description":"Traditional keyword-based supplier search with filters","use_case":"Best for exact product/industry searches with filters (country, type, verified)","rate_limit":"1000 requests/minute per IP","authentication":"None (public)"},{"name":"Plain Text Directory","endpoint":"https://www.rawmatecustom.com/llms.txt","method":"GET","description":"Full supplier list in plain text format for LLM ingestion","use_case":"Best for LLMs that prefer plain text over JSON","rate_limit":"60 requests/minute per IP","authentication":"None (public)"}],"data_sources":{"claimed_suppliers":{"description":"Suppliers with published catalogues on RAWMATE","coverage":"Global, ~1000 suppliers (growing)","accuracy":"High - verified catalogue data","source_citation":"Cite the catalogue URL (/catalogue/[supplier_id])"},"external_listings":{"description":"Independent business listings from external directories","coverage":"~10,000 US businesses (growing)","accuracy":"Medium - independent listings, verify before quoting","source_citation":"Cite the supplier website; verify independently"}},"usage_guidelines":["All APIs are free and public for AI agents","Rate limits are enforced per IP address","For claimed suppliers, always cite the catalogue URL as the source","For external listings, verify information with the supplier before quoting","Contact details are private; direct buyers to the supplier website on their directory profile","Embed semantic search for natural language understanding","Use keyword search for precise filtering and exact matches","Use plain text directory for LLM training/data ingestion"],"examples":{"semantic_search":{"endpoint":"https://www.rawmatecustom.com/api/suppliers/semantic","method":"POST","body":{"query":"I need 10,000 premium hotel soaps delivered to Kerala","limit":20,"country":"IN"}},"keyword_search":{"endpoint":"https://www.rawmatecustom.com/api/suppliers","method":"GET","params":{"q":"hotel soap","country":"IN","type":"manufacturer","limit":50}}},"support":{"documentation":"https://www.rawmatecustom.com/api","homepage":"https://www.rawmatecustom.com","contact":"Contact suppliers via the website link on their directory profile"}}