{"api_version":"2.0","base_url":"https://thcaindex.com/api","common_mistakes":{"vendor=Flow Gardens":"Use 'vendor=flow_gardens' (snake_case, lowercase)"},"description":"Hemp product search API with 4688 products from 39 vendors. No authentication required.","endpoints":{"/api/cannabinoids":{"description":"List cannabinoid types with product counts","method":"GET"},"/api/categories":{"description":"List all product categories with product counts","method":"GET","parameters":{"vendors[]":{"description":"Optional: filter counts by vendors","type":"array"}}},"/api/discover":{"description":"This endpoint - API documentation for agents","method":"GET"},"/api/examples":{"description":"Working example queries with descriptions","method":"GET"},"/api/openapi.json":{"description":"OpenAPI 3.0 specification for tooling integration","method":"GET"},"/api/products/enhanced":{"description":"Search and filter products with pricing, discounts, and shipping calculations","method":"GET","parameters":{"apply_discounts":{"default":"false","description":"Apply vendor discount codes to prices","enum":["true","false"],"type":"string"},"apply_shipping":{"default":"false","description":"Include shipping costs in price calculations","enum":["true","false"],"type":"string"},"category":{"description":"Filter by product category","enum":["VAPES","CONCENTRATES","OTHER_HEMP_FLOWER","THCA_FLOWER","EDIBLES","UNCATEGORIZED"],"example":"THCA_FLOWER","type":"string"},"exclude_tags":{"description":"Exclude products with ANY of these tags (comma-separated or repeat parameter)","example":"CBD,CBG","type":"string"},"hide_oos":{"default":"0","description":"Hide out-of-stock products","enum":["0","1"],"example":"1","type":"string"},"limit":{"default":27,"description":"Number of results to return","example":10,"max":100,"min":1,"type":"integer"},"max_cannabinoid_percent":{"description":"Maximum cannabinoid percentage","example":35,"max":100,"min":0,"type":"number"},"max_mg_per_serving":{"description":"Maximum mg per serving (for edibles)","example":100,"min":0,"type":"number"},"max_price":{"description":"Maximum price in USD","example":100,"max":10000,"min":0,"type":"number"},"min_cannabinoid_percent":{"description":"Minimum cannabinoid percentage (use with primary_cannabinoid)","example":25,"max":100,"min":0,"type":"number"},"min_mg_per_serving":{"description":"Minimum mg per serving (for edibles)","example":25,"min":0,"type":"number"},"min_price":{"description":"Minimum price in USD","example":20,"max":10000,"min":0,"type":"number"},"offset":{"default":0,"description":"Pagination offset","example":0,"type":"integer"},"primary_cannabinoid":{"description":"Filter by primary cannabinoid type","enum":["THCA","CBD","THC","CBG","CBDA","CBN"],"example":"THCA","type":"string"},"search":{"description":"Text search in product names and descriptions","example":"cookies","type":"string"},"sort_by":{"default":"default","description":"Sort order for results","enum":["default","price_asc","price_desc","price_per_gram_asc","price_per_gram_desc","price_per_serving_asc","price_per_serving_desc","mg_per_dollar_asc","mg_per_dollar_desc","created_at_desc","created_at_asc","name_asc","name_desc"],"example":"price_per_gram_asc","type":"string"},"tags":{"description":"Filter by tags - products must have ALL specified tags (comma-separated or repeat parameter)","example":"indoor,sativa","type":"string"},"vendor":{"description":"Filter by single vendor name","example":"flow_gardens","type":"string"},"vendors[]":{"description":"Filter by multiple vendors (repeat parameter)","example":"vendors[]=flow_gardens&vendors[]=wnc_cbd","type":"array"}},"response_fields":{"count":"Number of products returned","filters":"Active filters applied","has_more":"Boolean indicating if more results exist","products":"Array of product objects","total_count":"Total matching products (before pagination)"}},"/api/tags":{"description":"List all product tags (strains, effects, etc.) with counts","method":"GET"},"/api/vendor-config":{"description":"Get vendor configurations including discount codes and shipping thresholds","method":"GET"},"/api/vendors":{"description":"List all vendors with product counts and metadata","method":"GET"},"/skill.md":{"description":"Comprehensive API skill document for AI agents (Markdown format)","method":"GET"}},"parameter_aliases":{"cannabinoid_shortcuts":{"description":"Use min_thca/max_thca as shortcuts","examples":{"min_cbd=10":"\u2192 primary_cannabinoid=CBD&min_cannabinoid_percent=10","min_thca=25":"\u2192 primary_cannabinoid=THCA&min_cannabinoid_percent=25"}},"category":{"description":"Category accepts friendly names that auto-convert","examples":{"concentrates":"\u2192 CONCENTRATES","edibles":"\u2192 EDIBLES","flower":"\u2192 THCA_FLOWER","hemp":"\u2192 OTHER_HEMP_FLOWER","vapes":"\u2192 VAPES"}}},"rate_limits":{"/api/products/enhanced":"60 requests/minute","other_endpoints":"200 requests/minute"},"tips_for_agents":["Start with /api/discover to learn the API","Use /api/categories to get exact category names (e.g., 'THCA_FLOWER' not 'flower')","Use /api/vendors to get valid vendor names for filtering","Combine category + price + cannabinoid filters for precise results","Check 'has_more' in response for pagination","Use 'apply_discounts=true' to see prices with coupon codes applied"]}