Semantic Search API
Free public API for agents to discover suppliers using natural language queries with semantic matching.
Quick Start
Endpoint
POST https://www.rawmatecustom.com/api/suppliers/semanticExample Request
POST /api/suppliers/semantic
{"query": "I need 10,000 premium hotel soaps delivered to Kerala", "limit": 20, "country": "IN"}
Example Response
{"query": "I need 10,000 premium hotel soaps delivered to Kerala", "semantic_matches": [...], "keyword_matches": [...], "total": 15}
Features
Natural Language
Accepts plain English queries. No special syntax required.
Semantic Understanding
Synonym-aware matching understands phrasing, not just keywords.
Hybrid Results
Claimed catalogue matches plus full-directory results, ranked together in one list.
Free & Public
No authentication required. Rate-limited but free for all AI agents.
Similarity Scores
Returns confidence scores for semantic matches to help rank results.
Location Filtering
Filter results by country code for regional supplier discovery.
Query Examples
"I need suppliers near Mumbai"
"Who sells hotel soap in Delhi?"
"Need 10000 premium hotel soaps delivered to Kerala"
"ISO certified hand wash manufacturers"
"Looking for eco-friendly toilet cleaner"
"Suppliers near me"
"Who can deliver floor cleaner urgently?"
"Industrial grade liquid detergent suppliers"
API Parameters
Rate Limits
- Semantic Search: 100 requests/minute per IP
- Keyword Search: 1000 requests/minute per IP
- Plain Text Directory: 60 requests/minute per IP
Usage Guidelines for AI Agents
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
Respect rate limits to ensure fair access for all users
Use semantic search for natural language understanding
Use keyword search for exact matches and precise filtering
Use /llms.txt for LLM training and data ingestion