{"version":"1.1","base_url":"https://www.indrexa.com/api","endpoints":{"/api/products/{id}":"Full product record. Accepts Indrexa UUID, ASIN, or UPC","/api/products":"Filtered product index with pagination","/api/schema":"This document — read first to discover valid filter values and per-category spec fields"},"query_parameters":{"use_case":"filter by use_case tag (see available_use_case_tags)","category":"filter by category_id — must exactly match one of the available_categories keys (e.g. power_banks)","retailer":"filter by retailer name (see supported_retailers)","upc":"filter by UPC code","retailer_id":"filter by retailer-specific product ID — requires retailer param","sort":"sort order — valid values: price_asc, price_desc, rating, reviews, newest","limit":"results per page, 1–100 (default 20)","offset":"pagination offset (default 0)"},"id_types_accepted":["indrexa_uuid","asin","upc"],"universal_fields":["indrexa_id","category_id","product_title","brand","upc","asin","current_price_usd","average_rating","in_stock","semantic_description","best_for_summary","not_ideal_for","use_case_tags","buyer_profile_tags","review_intelligence"],"available_categories":{"bluetooth_speakers":"Portable Bluetooth Speakers","headphones":"Headphones & Earbuds","wireless_earbuds":"Wireless Earbuds","power_banks":"Portable Chargers & Power Banks"},"categories":{"bluetooth_speakers":{"display_name":"Portable Bluetooth Speakers","fields":[{"field_key":"output_power_watts","display_name":"Output Power Watts","data_type":"number","unit":"W","description":"float | null — rated output power in watts","is_filterable":false,"source":"typed_column"},{"field_key":"battery_life_hours","display_name":"Battery Life Hours","data_type":"number","unit":"hours","description":"float | null — battery life in hours","is_filterable":false,"source":"typed_column"},{"field_key":"waterproof_rating","display_name":"Waterproof Rating","data_type":"text","unit":null,"description":"str | null — e.g. IPX7","is_filterable":false,"source":"typed_column"},{"field_key":"bluetooth_version","display_name":"Bluetooth Version","data_type":"text","unit":null,"description":"str | null — e.g. 5.3","is_filterable":false,"source":"typed_column"},{"field_key":"frequency_response_low_hz","display_name":"Frequency Response Low Hz","data_type":"number","unit":"Hz","description":"float | null","is_filterable":false,"source":"typed_column"},{"field_key":"frequency_response_high_hz","display_name":"Frequency Response High Hz","data_type":"number","unit":"Hz","description":"float | null","is_filterable":false,"source":"typed_column"},{"field_key":"weight_oz","display_name":"Weight Oz","data_type":"number","unit":"oz","description":"float | null","is_filterable":false,"source":"typed_column"},{"field_key":"driver_size_mm","display_name":"Driver Size Mm","data_type":"number","unit":"mm","description":"float | null","is_filterable":false,"source":"typed_column"},{"field_key":"has_rgb_lights","display_name":"Has Rgb Lights","data_type":"boolean","unit":null,"description":"bool — has RGB or light show","is_filterable":false,"source":"typed_column"},{"field_key":"has_power_bank","display_name":"Has Power Bank","data_type":"boolean","unit":null,"description":"bool — can charge other devices","is_filterable":false,"source":"typed_column"},{"field_key":"is_floatable","display_name":"Is Floatable","data_type":"boolean","unit":null,"description":"bool — floats in water","is_filterable":false,"source":"typed_column"},{"field_key":"multi_speaker_pairing","display_name":"Multi Speaker Pairing","data_type":"boolean","unit":null,"description":"bool — pairs with other speakers","is_filterable":false,"source":"typed_column"},{"field_key":"has_lossless_audio","display_name":"Has Lossless Audio","data_type":"boolean","unit":null,"description":"bool — supports lossless codec","is_filterable":false,"source":"typed_column"},{"field_key":"is_rugged","display_name":"Is Rugged","data_type":"boolean","unit":null,"description":"bool — ruggedized/shockproof","is_filterable":false,"source":"typed_column"},{"field_key":"has_app_control","display_name":"Has App Control","data_type":"boolean","unit":null,"description":"bool — companion app","is_filterable":false,"source":"typed_column"},{"field_key":"has_built_in_microphone","display_name":"Has Built In Microphone","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"typed_column"},{"field_key":"has_voice_assistant","display_name":"Has Voice Assistant","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"typed_column"},{"field_key":"has_aux_input","display_name":"Has Aux Input","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"typed_column"},{"field_key":"audio_channels","display_name":"Audio Channels","data_type":"number","unit":null,"description":"Number of audio channels (e.g. 2 for stereo)","is_filterable":false,"source":"typed_column"},{"field_key":"connectivity_types","display_name":"Connectivity Types","data_type":"array","unit":null,"description":"Array of connectivity options supported (e.g. Bluetooth, AUX, USB)","is_filterable":false,"source":"typed_column"}]},"headphones":{"display_name":"Headphones & Earbuds","fields":[{"field_key":"driver_size_mm","display_name":"Driver Size Mm","data_type":"number","unit":"mm","description":"float | null — driver diameter in mm","is_filterable":false,"source":"category_specs"},{"field_key":"frequency_response_low_hz","display_name":"Frequency Response Low Hz","data_type":"number","unit":"Hz","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"frequency_response_high_hz","display_name":"Frequency Response High Hz","data_type":"number","unit":"Hz","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"battery_life_hours","display_name":"Battery Life Hours","data_type":"number","unit":"hours","description":"float | null — ONLY for wireless/Bluetooth models with a rechargeable battery. Must be null for wired headphones. Do NOT extract impedance, frequency response, or hours of warranty as battery life. Typical range: 4–100 hours.","is_filterable":false,"source":"category_specs"},{"field_key":"bluetooth_version","display_name":"Bluetooth Version","data_type":"text","unit":null,"description":"str | null — wireless models only","is_filterable":false,"source":"category_specs"},{"field_key":"weight_oz","display_name":"Weight Oz","data_type":"number","unit":"oz","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"waterproof_rating","display_name":"Waterproof Rating","data_type":"text","unit":null,"description":"str | null — IP rating if applicable","is_filterable":false,"source":"category_specs"},{"field_key":"impedance_ohms","display_name":"Impedance Ohms","data_type":"number","unit":"Ω","description":"float | null — impedance in ohms","is_filterable":false,"source":"category_specs"},{"field_key":"sensitivity_db","display_name":"Sensitivity Db","data_type":"number","unit":"dB","description":"float | null — sensitivity in dB","is_filterable":false,"source":"category_specs"},{"field_key":"max_input_power_mw","display_name":"Max Input Power Mw","data_type":"number","unit":"mW","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"has_active_noise_cancellation","display_name":"Has Active Noise Cancellation","data_type":"boolean","unit":null,"description":"bool — ANC","is_filterable":false,"source":"category_specs"},{"field_key":"has_transparency_mode","display_name":"Has Transparency Mode","data_type":"boolean","unit":null,"description":"bool — passthrough/awareness mode","is_filterable":false,"source":"category_specs"},{"field_key":"is_wireless","display_name":"Is Wireless","data_type":"boolean","unit":null,"description":"bool — Bluetooth or RF wireless","is_filterable":false,"source":"category_specs"},{"field_key":"has_wired_option","display_name":"Has Wired Option","data_type":"boolean","unit":null,"description":"bool — includes 3.5mm or USB-C cable","is_filterable":false,"source":"category_specs"},{"field_key":"is_foldable","display_name":"Is Foldable","data_type":"boolean","unit":null,"description":"bool — folds for portability","is_filterable":false,"source":"category_specs"},{"field_key":"has_built_in_microphone","display_name":"Has Built In Microphone","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_voice_assistant","display_name":"Has Voice Assistant","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_app_control","display_name":"Has App Control","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_multipoint_connection","display_name":"Has Multipoint Connection","data_type":"boolean","unit":null,"description":"bool — connects to 2+ devices","is_filterable":false,"source":"category_specs"},{"field_key":"is_open_back","display_name":"Is Open Back","data_type":"boolean","unit":null,"description":"bool — open-back design","is_filterable":false,"source":"category_specs"},{"field_key":"has_lossless_audio","display_name":"Has Lossless Audio","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"}]},"power_banks":{"display_name":"Portable Chargers & Power Banks","fields":[{"field_key":"capacity_mah","display_name":"Capacity Mah","data_type":"number","unit":"mAh","description":"int | null — capacity in mAh","is_filterable":false,"source":"category_specs"},{"field_key":"capacity_wh","display_name":"Capacity Wh","data_type":"number","unit":"Wh","description":"float | null — capacity in Wh","is_filterable":false,"source":"category_specs"},{"field_key":"max_output_watts","display_name":"Max Output Watts","data_type":"number","unit":"W","description":"float | null — max charging output","is_filterable":false,"source":"category_specs"},{"field_key":"max_input_watts","display_name":"Max Input Watts","data_type":"number","unit":"W","description":"float | null — max charging input","is_filterable":false,"source":"category_specs"},{"field_key":"weight_oz","display_name":"Weight Oz","data_type":"number","unit":"oz","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"number_of_ports","display_name":"Number Of Ports","data_type":"number","unit":null,"description":"int | null — total output ports","is_filterable":false,"source":"category_specs"},{"field_key":"usb_a_ports","display_name":"Usb A Ports","data_type":"number","unit":null,"description":"int | null","is_filterable":false,"source":"category_specs"},{"field_key":"usb_c_ports","display_name":"Usb C Ports","data_type":"number","unit":null,"description":"int | null","is_filterable":false,"source":"category_specs"},{"field_key":"has_wireless_charging","display_name":"Has Wireless Charging","data_type":"boolean","unit":null,"description":"bool — Qi output","is_filterable":false,"source":"category_specs"},{"field_key":"has_magsafe","display_name":"Has Magsafe","data_type":"boolean","unit":null,"description":"bool — MagSafe compatible","is_filterable":false,"source":"category_specs"},{"field_key":"has_fast_charging","display_name":"Has Fast Charging","data_type":"boolean","unit":null,"description":"bool — supports PD or QC","is_filterable":false,"source":"category_specs"},{"field_key":"has_built_in_cable","display_name":"Has Built In Cable","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_solar_panel","display_name":"Has Solar Panel","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"is_airline_approved","display_name":"Is Airline Approved","data_type":"boolean","unit":null,"description":"bool — under 100Wh FAA limit","is_filterable":false,"source":"category_specs"},{"field_key":"has_led_display","display_name":"Has Led Display","data_type":"boolean","unit":null,"description":"bool — digital capacity display","is_filterable":false,"source":"category_specs"},{"field_key":"has_pass_through_charging","display_name":"Has Pass Through Charging","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"is_slim_profile","display_name":"Is Slim Profile","data_type":"boolean","unit":null,"description":"bool — thin form factor","is_filterable":false,"source":"category_specs"}]},"wireless_earbuds":{"display_name":"Wireless Earbuds","fields":[{"field_key":"driver_size_mm","display_name":"Driver Size Mm","data_type":"number","unit":"mm","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"battery_life_hours","display_name":"Battery Life Hours","data_type":"number","unit":"hours","description":"float | null — ONLY for wireless/Bluetooth models with a rechargeable battery. Must be null for wired earbuds/IEMs. Do NOT extract impedance, frequency response, or hours of warranty as battery life. Typical range: 4–100 hours.","is_filterable":false,"source":"category_specs"},{"field_key":"case_battery_life_hours","display_name":"Case Battery Life Hours","data_type":"number","unit":"hours","description":"float | null — total with case","is_filterable":false,"source":"category_specs"},{"field_key":"bluetooth_version","display_name":"Bluetooth Version","data_type":"text","unit":null,"description":"str | null","is_filterable":false,"source":"category_specs"},{"field_key":"waterproof_rating","display_name":"Waterproof Rating","data_type":"text","unit":null,"description":"str | null","is_filterable":false,"source":"category_specs"},{"field_key":"weight_oz","display_name":"Weight Oz","data_type":"number","unit":"oz","description":"float | null — per earbud weight","is_filterable":false,"source":"category_specs"},{"field_key":"frequency_response_low_hz","display_name":"Frequency Response Low Hz","data_type":"number","unit":"Hz","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"frequency_response_high_hz","display_name":"Frequency Response High Hz","data_type":"number","unit":"Hz","description":"float | null","is_filterable":false,"source":"category_specs"},{"field_key":"has_active_noise_cancellation","display_name":"Has Active Noise Cancellation","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_transparency_mode","display_name":"Has Transparency Mode","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_wireless_charging","display_name":"Has Wireless Charging","data_type":"boolean","unit":null,"description":"bool — case supports Qi charging","is_filterable":false,"source":"category_specs"},{"field_key":"is_multipoint","display_name":"Is Multipoint","data_type":"boolean","unit":null,"description":"bool — connects to 2+ devices","is_filterable":false,"source":"category_specs"},{"field_key":"has_built_in_microphone","display_name":"Has Built In Microphone","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_voice_assistant","display_name":"Has Voice Assistant","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_app_control","display_name":"Has App Control","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_ear_tips_multiple_sizes","display_name":"Has Ear Tips Multiple Sizes","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"has_lossless_audio","display_name":"Has Lossless Audio","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"},{"field_key":"is_stem_design","display_name":"Is Stem Design","data_type":"boolean","unit":null,"description":"bool — has stem like AirPods","is_filterable":false,"source":"category_specs"},{"field_key":"has_touch_controls","display_name":"Has Touch Controls","data_type":"boolean","unit":null,"description":"bool","is_filterable":false,"source":"category_specs"}]}},"shipping_fields":{"free_shipping_available":"boolean","free_shipping_note":"text — e.g. free with Prime, free with Walmart+","min_order_for_free_shipping":"numeric USD, null if no minimum"},"supported_retailers":["amazon"],"available_use_case_tags":["android","audiophile","beach","budget-friendly","business-travel","calls","camping","casual-listener","commuter","commuting","emergency","everyday-carry","gaming","gift","gym","hiking","home","iphone","kids","laptop-charging","noise-cancelling","office","outdoor","outdoor-enthusiast","party","podcast","pool","premium","premium-audio","rugged","running","shower","studio","travel","workout"],"_llm_hints":{"purpose":"Read this endpoint first before querying /api/products to understand valid filter values and per-category spec fields","category_filter_note":"?category= must be an exact category_id key from available_categories (e.g. ?category=power_banks). Human-readable names like 'Portable Power Banks' will return empty results.","category_specs_note":"Non-speaker products return specs under category_specs in the detail response. Bluetooth speakers return specs as typed top-level fields (see categories.bluetooth_speakers.fields with source=typed_column).","shipping_note":"shipping costs are estimates only — final cost depends on user location and membership status","null_fields":"null values in spec or review fields mean source data was unavailable — do not infer"}}