{"openapi":"3.1.0","info":{"title":"ShopLeads API","version":"1.0"},"servers":[{"url":"https://api.shopleads.io"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"paths":{"/api/v1/stores":{"get":{"operationId":"search_stores_get","summary":"Free: never reveals a contact and never spends credits. Search AI-confirmed DTC stores in the live database. Returns one page and a next_cursor. sells= keeps stores with a product matching every word.","security":[{"bearer":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Words in the name, domain, description, keywords, apps or tools"},{"name":"domains","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Exact store domains"},{"name":"vertical","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these verticals"},{"name":"band","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Monthly sales band"},{"name":"min_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Monthly sales at least, USD"},{"name":"max_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Monthly sales at most, USD"},{"name":"platform","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these platforms"},{"name":"country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these countries (ISO code)"},{"name":"dtc","in":"query","schema":{"type":"boolean"},"description":"true: real DTC brands only; false: everything else"},{"name":"own_stores","in":"query","schema":{"type":"boolean"},"description":"Runs its own physical stores"},{"name":"online_only","in":"query","schema":{"type":"boolean"},"description":"Site scan worked and found no physical stores"},{"name":"in_retailers","in":"query","schema":{"type":"boolean"},"description":"Sold through other retailers (stockists, wholesale)"},{"name":"tools","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Every one of these apps or technologies is installed (exact names)"},{"name":"gaps","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Every one of these tech gaps"},{"name":"signals","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has at least one signal of each kind (Pro and Scale)"},{"name":"signals_any","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has a signal of at least one of these kinds (Pro and Scale)"},{"name":"traits","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has every one of these standing store traits (open on every plan)"},{"name":"sells","in":"query","schema":{"type":"string"},"description":"Sells a product matching every one of these words (product title, type, tags or description)"},{"name":"min_followers","in":"query","schema":{"type":"integer","minimum":0},"description":"Social followers at least, all networks together"},{"name":"has_dm_email","in":"query","schema":{"type":"boolean"},"description":"A decision-maker has a work email"},{"name":"has_mobile","in":"query","schema":{"type":"boolean"},"description":"Someone has a mobile number"},{"name":"category","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store category, any of these (top-level e-commerce category, e.g. Apparel, Sports, Beauty & Fitness, Food & Drink, Home & Garden)"},{"name":"socials","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has a profile on every one of these networks"},{"name":"min_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Installed apps at least"},{"name":"max_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Installed apps at most"},{"name":"founder_found","in":"query","schema":{"type":"boolean"},"description":"true: the owner or founder is among the people found"},{"name":"price_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Price tier: any of these (brand profile)"},{"name":"purchase_cycle","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Purchase cycle: any of these (brand profile)"},{"name":"audience_gender","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Audience: any of these (brand profile)"},{"name":"audience_life_stage","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Life stage: any of these (brand profile)"},{"name":"sales_model","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Sales model: any of these (brand profile)"},{"name":"channels","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Channels: any of these (brand profile)"},{"name":"regulated","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Regulated: any of these (brand profile)"},{"name":"seasonality","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Seasonality: any of these (brand profile)"},{"name":"best_fit_vendors","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Best-fit vendors: any of these (brand profile)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["sales","fit","signals","name"]},"description":"sales (default), fit, signals or name. Sorting reads the sample index."},{"name":"source","in":"query","schema":{"type":"string","enum":["live","sample"]},"description":"live (default): the live database; sample: the sample index. Filters with no live equivalent read the sample and say so."},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":0},"description":"Rows per page, 1-50"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/stores/search":{"post":{"operationId":"search_stores_post","summary":"Free: never reveals a contact and never spends credits. Search AI-confirmed DTC stores in the live database. Returns one page and a next_cursor. sells= keeps stores with a product matching every word.","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"domains":{"type":"array","items":{"type":"string"}},"vertical":{"type":"array","items":{"type":"string","enum":["apparel_accessories","arts_crafts_hobbies","auto_vehicles","baby_kids_toys","beauty_personal_care","electronics_tech","food_beverage","general_merchandise","gifts_party_flowers","health_wellness","home_garden","industrial_business","not_applicable","other_products","pets","sports_outdoors"]}},"band":{"type":"array","items":{"type":"string","enum":["10k-100k","100k-1M","1M-10M","10M+"]}},"min_sales":{"type":"integer","minimum":0},"max_sales":{"type":"integer","minimum":0},"platform":{"type":"array","items":{"type":"string","enum":["3dcart","bigcommerce","bvcommerce","centra","commerce7","commercev3","custom","demandware","drupal","dukaan","easydigital","ecbeing","ecwid","fbits","godaddy","hcl","idosell","ikas","lightspeed","magento","makeshop","miva","nop","orderport","prestashop","rain","sap","scayle","shopify","shopware","shopwp","sitecore","snipcart","sote","spreecommerce","square","squarespace","volusion","vtex","webflow","wix","woocommerce"]}},"country":{"type":"array","items":{"type":"string","enum":["AE","AT","AU","BE","BM","BR","CA","CH","CL","CN","CZ","DE","DK","DZ","EG","ES","FI","FR","GB","GG","HK","ID","IE","IN","IT","JP","LT","LU","MA","MT","MX","NL","NO","PH","PL","SE","SG","TH","TR","US","ZA"]}},"dtc":{"type":"boolean"},"own_stores":{"type":"boolean"},"online_only":{"type":"boolean"},"in_retailers":{"type":"boolean"},"tools":{"type":"array","items":{"type":"string"}},"gaps":{"type":"array","items":{"type":"string","enum":["no email/SMS platform","no SMS","no reviews app","no subscriptions","no loyalty","no helpdesk","no upsell"]}},"signals":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"signals_any":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"traits":{"type":"array","items":{"type":"string","enum":["affiliate_program","multi_market","press_mentions","subscription_offer","wholesale_program"]}},"sells":{"type":"string"},"min_followers":{"type":"integer","minimum":0},"has_dm_email":{"type":"boolean"},"has_mobile":{"type":"boolean"},"category":{"type":"array","items":{"type":"string"}},"socials":{"type":"array","items":{"type":"string","enum":["instagram","facebook","tiktok","youtube","pinterest","x","linkedin"]}},"min_apps":{"type":"integer","minimum":0},"max_apps":{"type":"integer","minimum":0},"founder_found":{"type":"boolean"},"price_tier":{"type":"array","items":{"type":"string","enum":["budget","mid","premium","luxury"]}},"purchase_cycle":{"type":"array","items":{"type":"string","enum":["one_time","occasional","replenishable"]}},"audience_gender":{"type":"array","items":{"type":"string","enum":["women","men","unisex","kids"]}},"audience_life_stage":{"type":"array","items":{"type":"string","enum":["kids","teens","adults","parents","seniors","pets"]}},"sales_model":{"type":"array","items":{"type":"string","enum":["subscription","bundles","made_to_order","personalized","wholesale","gifting"]}},"channels":{"type":"array","items":{"type":"string","enum":["own_store_only","amazon","retail_stockists","own_retail_stores","marketplaces"]}},"regulated":{"type":"array","items":{"type":"string","enum":["alcohol","cbd_hemp","supplements","tobacco_vape","firearms","adult","none"]}},"seasonality":{"type":"array","items":{"type":"string","enum":["holiday_q4","summer","back_to_school","valentines","mothers_fathers_day","none"]}},"best_fit_vendors":{"type":"array","items":{"type":"string","enum":["email_sms_agency","paid_social_agency","influencer_ugc","seo_content","cro_web","3pl_fulfillment","subscription_app","reviews_ugc_app","wholesale_platform","packaging","product_photography","retail_distribution"]}},"sort":{"type":"string","enum":["sales","fit","signals","name"]},"source":{"type":"string","enum":["live","sample"]},"page_size":{"type":"integer","minimum":0},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/stores/count":{"get":{"operationId":"count_stores_get","summary":"Free: never reveals a contact and never spends credits. Count the stores that match, without returning rows: the live database's exact count when it finishes within about 25 seconds (exact: true), else its estimate (exact: false). Filters the live database cannot answer count the sample index instead (source: sample).","security":[{"bearer":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Words in the name, domain, description, keywords, apps or tools"},{"name":"domains","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Exact store domains"},{"name":"vertical","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these verticals"},{"name":"band","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Monthly sales band"},{"name":"min_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Monthly sales at least, USD"},{"name":"max_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Monthly sales at most, USD"},{"name":"platform","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these platforms"},{"name":"country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these countries (ISO code)"},{"name":"dtc","in":"query","schema":{"type":"boolean"},"description":"true: real DTC brands only; false: everything else"},{"name":"own_stores","in":"query","schema":{"type":"boolean"},"description":"Runs its own physical stores"},{"name":"online_only","in":"query","schema":{"type":"boolean"},"description":"Site scan worked and found no physical stores"},{"name":"in_retailers","in":"query","schema":{"type":"boolean"},"description":"Sold through other retailers (stockists, wholesale)"},{"name":"tools","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Every one of these apps or technologies is installed (exact names)"},{"name":"gaps","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Every one of these tech gaps"},{"name":"signals","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has at least one signal of each kind (Pro and Scale)"},{"name":"signals_any","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has a signal of at least one of these kinds (Pro and Scale)"},{"name":"traits","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has every one of these standing store traits (open on every plan)"},{"name":"sells","in":"query","schema":{"type":"string"},"description":"Sells a product matching every one of these words (product title, type, tags or description)"},{"name":"min_followers","in":"query","schema":{"type":"integer","minimum":0},"description":"Social followers at least, all networks together"},{"name":"has_dm_email","in":"query","schema":{"type":"boolean"},"description":"A decision-maker has a work email"},{"name":"has_mobile","in":"query","schema":{"type":"boolean"},"description":"Someone has a mobile number"},{"name":"category","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store category, any of these (top-level e-commerce category, e.g. Apparel, Sports, Beauty & Fitness, Food & Drink, Home & Garden)"},{"name":"socials","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Has a profile on every one of these networks"},{"name":"min_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Installed apps at least"},{"name":"max_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Installed apps at most"},{"name":"founder_found","in":"query","schema":{"type":"boolean"},"description":"true: the owner or founder is among the people found"},{"name":"price_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Price tier: any of these (brand profile)"},{"name":"purchase_cycle","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Purchase cycle: any of these (brand profile)"},{"name":"audience_gender","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Audience: any of these (brand profile)"},{"name":"audience_life_stage","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Life stage: any of these (brand profile)"},{"name":"sales_model","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Sales model: any of these (brand profile)"},{"name":"channels","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Channels: any of these (brand profile)"},{"name":"regulated","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Regulated: any of these (brand profile)"},{"name":"seasonality","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Seasonality: any of these (brand profile)"},{"name":"best_fit_vendors","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Best-fit vendors: any of these (brand profile)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["sales","fit","signals","name"]},"description":"sales (default), fit, signals or name. Sorting reads the sample index."},{"name":"source","in":"query","schema":{"type":"string","enum":["live","sample"]},"description":"live (default): the live database; sample: the sample index. Filters with no live equivalent read the sample and say so."},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":0},"description":"Rows per page, 1-50"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}},"post":{"operationId":"count_stores_post","summary":"Free: never reveals a contact and never spends credits. Count the stores that match, without returning rows: the live database's exact count when it finishes within about 25 seconds (exact: true), else its estimate (exact: false). Filters the live database cannot answer count the sample index instead (source: sample).","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"domains":{"type":"array","items":{"type":"string"}},"vertical":{"type":"array","items":{"type":"string","enum":["apparel_accessories","arts_crafts_hobbies","auto_vehicles","baby_kids_toys","beauty_personal_care","electronics_tech","food_beverage","general_merchandise","gifts_party_flowers","health_wellness","home_garden","industrial_business","not_applicable","other_products","pets","sports_outdoors"]}},"band":{"type":"array","items":{"type":"string","enum":["10k-100k","100k-1M","1M-10M","10M+"]}},"min_sales":{"type":"integer","minimum":0},"max_sales":{"type":"integer","minimum":0},"platform":{"type":"array","items":{"type":"string","enum":["3dcart","bigcommerce","bvcommerce","centra","commerce7","commercev3","custom","demandware","drupal","dukaan","easydigital","ecbeing","ecwid","fbits","godaddy","hcl","idosell","ikas","lightspeed","magento","makeshop","miva","nop","orderport","prestashop","rain","sap","scayle","shopify","shopware","shopwp","sitecore","snipcart","sote","spreecommerce","square","squarespace","volusion","vtex","webflow","wix","woocommerce"]}},"country":{"type":"array","items":{"type":"string","enum":["AE","AT","AU","BE","BM","BR","CA","CH","CL","CN","CZ","DE","DK","DZ","EG","ES","FI","FR","GB","GG","HK","ID","IE","IN","IT","JP","LT","LU","MA","MT","MX","NL","NO","PH","PL","SE","SG","TH","TR","US","ZA"]}},"dtc":{"type":"boolean"},"own_stores":{"type":"boolean"},"online_only":{"type":"boolean"},"in_retailers":{"type":"boolean"},"tools":{"type":"array","items":{"type":"string"}},"gaps":{"type":"array","items":{"type":"string","enum":["no email/SMS platform","no SMS","no reviews app","no subscriptions","no loyalty","no helpdesk","no upsell"]}},"signals":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"signals_any":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"traits":{"type":"array","items":{"type":"string","enum":["affiliate_program","multi_market","press_mentions","subscription_offer","wholesale_program"]}},"sells":{"type":"string"},"min_followers":{"type":"integer","minimum":0},"has_dm_email":{"type":"boolean"},"has_mobile":{"type":"boolean"},"category":{"type":"array","items":{"type":"string"}},"socials":{"type":"array","items":{"type":"string","enum":["instagram","facebook","tiktok","youtube","pinterest","x","linkedin"]}},"min_apps":{"type":"integer","minimum":0},"max_apps":{"type":"integer","minimum":0},"founder_found":{"type":"boolean"},"price_tier":{"type":"array","items":{"type":"string","enum":["budget","mid","premium","luxury"]}},"purchase_cycle":{"type":"array","items":{"type":"string","enum":["one_time","occasional","replenishable"]}},"audience_gender":{"type":"array","items":{"type":"string","enum":["women","men","unisex","kids"]}},"audience_life_stage":{"type":"array","items":{"type":"string","enum":["kids","teens","adults","parents","seniors","pets"]}},"sales_model":{"type":"array","items":{"type":"string","enum":["subscription","bundles","made_to_order","personalized","wholesale","gifting"]}},"channels":{"type":"array","items":{"type":"string","enum":["own_store_only","amazon","retail_stockists","own_retail_stores","marketplaces"]}},"regulated":{"type":"array","items":{"type":"string","enum":["alcohol","cbd_hemp","supplements","tobacco_vape","firearms","adult","none"]}},"seasonality":{"type":"array","items":{"type":"string","enum":["holiday_q4","summer","back_to_school","valentines","mothers_fathers_day","none"]}},"best_fit_vendors":{"type":"array","items":{"type":"string","enum":["email_sms_agency","paid_social_agency","influencer_ugc","seo_content","cro_web","3pl_fulfillment","subscription_app","reviews_ugc_app","wholesale_platform","packaging","product_photography","retail_distribution"]}},"sort":{"type":"string","enum":["sales","fit","signals","name"]},"source":{"type":"string","enum":["live","sample"]},"page_size":{"type":"integer","minimum":0},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/people/count":{"get":{"operationId":"count_people_get","summary":"Free: never reveals a contact and never spends credits. Count the people that match, without returning rows: the live database's exact count when it finishes within about 25 seconds (exact: true). Broad searches may not finish; narrow them for an exact number.","security":[{"bearer":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Words in the name, title or store name"},{"name":"domains","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: exact store domains"},{"name":"vertical","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these verticals"},{"name":"band","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: monthly sales band"},{"name":"min_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: monthly sales at least, USD"},{"name":"max_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: monthly sales at most, USD"},{"name":"platform","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these platforms"},{"name":"country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these countries (ISO code)"},{"name":"dtc","in":"query","schema":{"type":"boolean"},"description":"Store: true: real DTC brands only; false: everything else"},{"name":"own_stores","in":"query","schema":{"type":"boolean"},"description":"Store: runs its own physical stores"},{"name":"online_only","in":"query","schema":{"type":"boolean"},"description":"Store: site scan worked and found no physical stores"},{"name":"in_retailers","in":"query","schema":{"type":"boolean"},"description":"Store: sold through other retailers (stockists, wholesale)"},{"name":"tools","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: every one of these apps or technologies is installed (exact names)"},{"name":"gaps","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: every one of these tech gaps"},{"name":"signals","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has at least one signal of each kind (Pro and Scale)"},{"name":"signals_any","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has a signal of at least one of these kinds (Pro and Scale)"},{"name":"traits","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has every one of these standing store traits (open on every plan)"},{"name":"sells","in":"query","schema":{"type":"string"},"description":"Store: sells a product matching every one of these words (product title, type, tags or description)"},{"name":"min_followers","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: social followers at least, all networks together"},{"name":"category","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: store category, any of these (top-level e-commerce category, e.g. Apparel, Sports, Beauty & Fitness, Food & Drink, Home & Garden)"},{"name":"socials","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has a profile on every one of these networks"},{"name":"min_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: installed apps at least"},{"name":"max_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: installed apps at most"},{"name":"founder_found","in":"query","schema":{"type":"boolean"},"description":"Store: true: the owner or founder is among the people found"},{"name":"price_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: price tier: any of these (brand profile)"},{"name":"purchase_cycle","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: purchase cycle: any of these (brand profile)"},{"name":"audience_gender","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: audience: any of these (brand profile)"},{"name":"audience_life_stage","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: life stage: any of these (brand profile)"},{"name":"sales_model","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: sales model: any of these (brand profile)"},{"name":"channels","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: channels: any of these (brand profile)"},{"name":"regulated","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: regulated: any of these (brand profile)"},{"name":"seasonality","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: seasonality: any of these (brand profile)"},{"name":"best_fit_vendors","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: best-fit vendors: any of these (brand profile)"},{"name":"seniority","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these levels: owner_founder, c_suite, vp, head_director, manager, other"},{"name":"department","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these departments (the broad list)"},{"name":"departments","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these departments from the finer list of about 30 (sales apart from wholesale, founders and owners, ecommerce, retention …); the keys are in GET /api/v1 under departments"},{"name":"title","in":"query","schema":{"type":"string"},"description":"Title holds every one of these words"},{"name":"titles","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Title holds any one of these phrases, e.g. founder, head of ecommerce, VP marketing (up to 25)"},{"name":"exclude_titles","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Leave out titles holding any of these phrases, e.g. assistant, intern (up to 25)"},{"name":"location","in":"query","schema":{"type":"string"},"description":"Location holds this text (city, region or country)"},{"name":"person_country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Where the person is, ISO code (US, GB, CA …)"},{"name":"dm","in":"query","schema":{"type":"boolean"},"description":"Decision-makers only"},{"name":"has_email","in":"query","schema":{"type":"boolean"},"description":"Has a work email"},{"name":"email_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Email checked by a verifier (verified) or catch-all and not confirmed (unconfirmed)"},{"name":"has_mobile","in":"query","schema":{"type":"boolean"},"description":"Has a mobile number"},{"name":"has_direct","in":"query","schema":{"type":"boolean"},"description":"Has a direct dial"},{"name":"has_linkedin","in":"query","schema":{"type":"boolean"},"description":"Has a LinkedIn profile"},{"name":"started_within_days","in":"query","schema":{"type":"integer","minimum":0},"description":"Started the current role within this many days (Pro and Scale)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["seniority","name","store","role_start"]},"description":"seniority (default), name, store or role_start (newest first). Sorting reads the sample index."},{"name":"source","in":"query","schema":{"type":"string","enum":["live","sample"]},"description":"live (default): the live database; sample: the sample index. Filters with no live equivalent read the sample and say so."},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":0},"description":"Rows per page, 1-50"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}},"post":{"operationId":"count_people_post","summary":"Free: never reveals a contact and never spends credits. Count the people that match, without returning rows: the live database's exact count when it finishes within about 25 seconds (exact: true). Broad searches may not finish; narrow them for an exact number.","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"domains":{"type":"array","items":{"type":"string"}},"vertical":{"type":"array","items":{"type":"string","enum":["apparel_accessories","arts_crafts_hobbies","auto_vehicles","baby_kids_toys","beauty_personal_care","electronics_tech","food_beverage","general_merchandise","gifts_party_flowers","health_wellness","home_garden","industrial_business","not_applicable","other_products","pets","sports_outdoors"]}},"band":{"type":"array","items":{"type":"string","enum":["10k-100k","100k-1M","1M-10M","10M+"]}},"min_sales":{"type":"integer","minimum":0},"max_sales":{"type":"integer","minimum":0},"platform":{"type":"array","items":{"type":"string","enum":["3dcart","bigcommerce","bvcommerce","centra","commerce7","commercev3","custom","demandware","drupal","dukaan","easydigital","ecbeing","ecwid","fbits","godaddy","hcl","idosell","ikas","lightspeed","magento","makeshop","miva","nop","orderport","prestashop","rain","sap","scayle","shopify","shopware","shopwp","sitecore","snipcart","sote","spreecommerce","square","squarespace","volusion","vtex","webflow","wix","woocommerce"]}},"country":{"type":"array","items":{"type":"string","enum":["AE","AT","AU","BE","BM","BR","CA","CH","CL","CN","CZ","DE","DK","DZ","EG","ES","FI","FR","GB","GG","HK","ID","IE","IN","IT","JP","LT","LU","MA","MT","MX","NL","NO","PH","PL","SE","SG","TH","TR","US","ZA"]}},"dtc":{"type":"boolean"},"own_stores":{"type":"boolean"},"online_only":{"type":"boolean"},"in_retailers":{"type":"boolean"},"tools":{"type":"array","items":{"type":"string"}},"gaps":{"type":"array","items":{"type":"string","enum":["no email/SMS platform","no SMS","no reviews app","no subscriptions","no loyalty","no helpdesk","no upsell"]}},"signals":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"signals_any":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"traits":{"type":"array","items":{"type":"string","enum":["affiliate_program","multi_market","press_mentions","subscription_offer","wholesale_program"]}},"sells":{"type":"string"},"min_followers":{"type":"integer","minimum":0},"category":{"type":"array","items":{"type":"string"}},"socials":{"type":"array","items":{"type":"string","enum":["instagram","facebook","tiktok","youtube","pinterest","x","linkedin"]}},"min_apps":{"type":"integer","minimum":0},"max_apps":{"type":"integer","minimum":0},"founder_found":{"type":"boolean"},"price_tier":{"type":"array","items":{"type":"string","enum":["budget","mid","premium","luxury"]}},"purchase_cycle":{"type":"array","items":{"type":"string","enum":["one_time","occasional","replenishable"]}},"audience_gender":{"type":"array","items":{"type":"string","enum":["women","men","unisex","kids"]}},"audience_life_stage":{"type":"array","items":{"type":"string","enum":["kids","teens","adults","parents","seniors","pets"]}},"sales_model":{"type":"array","items":{"type":"string","enum":["subscription","bundles","made_to_order","personalized","wholesale","gifting"]}},"channels":{"type":"array","items":{"type":"string","enum":["own_store_only","amazon","retail_stockists","own_retail_stores","marketplaces"]}},"regulated":{"type":"array","items":{"type":"string","enum":["alcohol","cbd_hemp","supplements","tobacco_vape","firearms","adult","none"]}},"seasonality":{"type":"array","items":{"type":"string","enum":["holiday_q4","summer","back_to_school","valentines","mothers_fathers_day","none"]}},"best_fit_vendors":{"type":"array","items":{"type":"string","enum":["email_sms_agency","paid_social_agency","influencer_ugc","seo_content","cro_web","3pl_fulfillment","subscription_app","reviews_ugc_app","wholesale_platform","packaging","product_photography","retail_distribution"]}},"seniority":{"type":"array","items":{"type":"string","enum":["owner_founder","c_suite","vp","head_director","manager","other"]}},"department":{"type":"array","items":{"type":"string","enum":["executive","ecommerce","growth_performance","marketing","customer_experience","operations_supply_chain","sales_wholesale","product","creative_brand","technology","finance","people_hr","other"]}},"departments":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"titles":{"type":"array","items":{"type":"string"}},"exclude_titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"person_country":{"type":"array","items":{"type":"string"}},"dm":{"type":"boolean"},"has_email":{"type":"boolean"},"email_tier":{"type":"array","items":{"type":"string","enum":["verified","unconfirmed"]}},"has_mobile":{"type":"boolean"},"has_direct":{"type":"boolean"},"has_linkedin":{"type":"boolean"},"started_within_days":{"type":"integer","minimum":0},"sort":{"type":"string","enum":["seniority","name","store","role_start"]},"source":{"type":"string","enum":["live","sample"]},"page_size":{"type":"integer","minimum":0},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/stores/{domain}":{"get":{"operationId":"get_store_get","summary":"Free: never reveals a contact and never spends credits. One store: details, socials, tools, personalization variables, people with contacts masked, and signals (Pro and Scale). Pass company_id from search_stores or search_people for the live record (REST: GET /api/v1/stores/<company_id>), or a domain.","security":[{"bearer":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}},{"name":"company_id","in":"query","schema":{"type":"string"},"description":"company_id from search_stores or search_people (live record)"},{"name":"source","in":"query","schema":{"type":"string","enum":["live","sample"]},"description":"live (default): the live database; sample: the sample index. Filters with no live equivalent read the sample and say so."}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/people/search":{"post":{"operationId":"search_people_post","summary":"Free: never reveals a contact and never spends credits. Search people at AI-confirmed DTC stores in the live database: store filters plus seniority, department, titles (any of several, or leave some out), location, contact and role-start filters. Emails, phones and LinkedIn stay masked; each row says what can be unlocked.","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"domains":{"type":"array","items":{"type":"string"}},"vertical":{"type":"array","items":{"type":"string","enum":["apparel_accessories","arts_crafts_hobbies","auto_vehicles","baby_kids_toys","beauty_personal_care","electronics_tech","food_beverage","general_merchandise","gifts_party_flowers","health_wellness","home_garden","industrial_business","not_applicable","other_products","pets","sports_outdoors"]}},"band":{"type":"array","items":{"type":"string","enum":["10k-100k","100k-1M","1M-10M","10M+"]}},"min_sales":{"type":"integer","minimum":0},"max_sales":{"type":"integer","minimum":0},"platform":{"type":"array","items":{"type":"string","enum":["3dcart","bigcommerce","bvcommerce","centra","commerce7","commercev3","custom","demandware","drupal","dukaan","easydigital","ecbeing","ecwid","fbits","godaddy","hcl","idosell","ikas","lightspeed","magento","makeshop","miva","nop","orderport","prestashop","rain","sap","scayle","shopify","shopware","shopwp","sitecore","snipcart","sote","spreecommerce","square","squarespace","volusion","vtex","webflow","wix","woocommerce"]}},"country":{"type":"array","items":{"type":"string","enum":["AE","AT","AU","BE","BM","BR","CA","CH","CL","CN","CZ","DE","DK","DZ","EG","ES","FI","FR","GB","GG","HK","ID","IE","IN","IT","JP","LT","LU","MA","MT","MX","NL","NO","PH","PL","SE","SG","TH","TR","US","ZA"]}},"dtc":{"type":"boolean"},"own_stores":{"type":"boolean"},"online_only":{"type":"boolean"},"in_retailers":{"type":"boolean"},"tools":{"type":"array","items":{"type":"string"}},"gaps":{"type":"array","items":{"type":"string","enum":["no email/SMS platform","no SMS","no reviews app","no subscriptions","no loyalty","no helpdesk","no upsell"]}},"signals":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"signals_any":{"type":"array","items":{"type":"string","enum":["app_installed","tech_installed","product_launch","catalog_growth","plan_change","replatform","new_store","new_in_role","hiring","headcount_growth","google_ads","funding","sale_live","sale_timer","stale_promo","markdowns_live","free_shipping_offer","shipping_delay","bad_reviews","meta_ads_live","meta_ads_burst","meta_ads_stopped","meta_ads","new_advertiser","google_ads_live","follower_growth","agency_of_record","app_removed","partnership","store_opening","press_event","headcount_decline","new_decision_maker","store_launched","platform_change","pixel_added","marketplace_presence","sale_running","own_stores","stockists","countdown_timer"]}},"traits":{"type":"array","items":{"type":"string","enum":["affiliate_program","multi_market","press_mentions","subscription_offer","wholesale_program"]}},"sells":{"type":"string"},"min_followers":{"type":"integer","minimum":0},"category":{"type":"array","items":{"type":"string"}},"socials":{"type":"array","items":{"type":"string","enum":["instagram","facebook","tiktok","youtube","pinterest","x","linkedin"]}},"min_apps":{"type":"integer","minimum":0},"max_apps":{"type":"integer","minimum":0},"founder_found":{"type":"boolean"},"price_tier":{"type":"array","items":{"type":"string","enum":["budget","mid","premium","luxury"]}},"purchase_cycle":{"type":"array","items":{"type":"string","enum":["one_time","occasional","replenishable"]}},"audience_gender":{"type":"array","items":{"type":"string","enum":["women","men","unisex","kids"]}},"audience_life_stage":{"type":"array","items":{"type":"string","enum":["kids","teens","adults","parents","seniors","pets"]}},"sales_model":{"type":"array","items":{"type":"string","enum":["subscription","bundles","made_to_order","personalized","wholesale","gifting"]}},"channels":{"type":"array","items":{"type":"string","enum":["own_store_only","amazon","retail_stockists","own_retail_stores","marketplaces"]}},"regulated":{"type":"array","items":{"type":"string","enum":["alcohol","cbd_hemp","supplements","tobacco_vape","firearms","adult","none"]}},"seasonality":{"type":"array","items":{"type":"string","enum":["holiday_q4","summer","back_to_school","valentines","mothers_fathers_day","none"]}},"best_fit_vendors":{"type":"array","items":{"type":"string","enum":["email_sms_agency","paid_social_agency","influencer_ugc","seo_content","cro_web","3pl_fulfillment","subscription_app","reviews_ugc_app","wholesale_platform","packaging","product_photography","retail_distribution"]}},"seniority":{"type":"array","items":{"type":"string","enum":["owner_founder","c_suite","vp","head_director","manager","other"]}},"department":{"type":"array","items":{"type":"string","enum":["executive","ecommerce","growth_performance","marketing","customer_experience","operations_supply_chain","sales_wholesale","product","creative_brand","technology","finance","people_hr","other"]}},"departments":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"titles":{"type":"array","items":{"type":"string"}},"exclude_titles":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"person_country":{"type":"array","items":{"type":"string"}},"dm":{"type":"boolean"},"has_email":{"type":"boolean"},"email_tier":{"type":"array","items":{"type":"string","enum":["verified","unconfirmed"]}},"has_mobile":{"type":"boolean"},"has_direct":{"type":"boolean"},"has_linkedin":{"type":"boolean"},"started_within_days":{"type":"integer","minimum":0},"sort":{"type":"string","enum":["seniority","name","store","role_start"]},"source":{"type":"string","enum":["live","sample"]},"page_size":{"type":"integer","minimum":0},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}},"get":{"operationId":"search_people_get_alt","summary":"Free: never reveals a contact and never spends credits. Search people at AI-confirmed DTC stores in the live database: store filters plus seniority, department, titles (any of several, or leave some out), location, contact and role-start filters. Emails, phones and LinkedIn stay masked; each row says what can be unlocked.","security":[{"bearer":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Words in the name, title or store name"},{"name":"domains","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: exact store domains"},{"name":"vertical","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these verticals"},{"name":"band","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: monthly sales band"},{"name":"min_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: monthly sales at least, USD"},{"name":"max_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: monthly sales at most, USD"},{"name":"platform","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these platforms"},{"name":"country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these countries (ISO code)"},{"name":"dtc","in":"query","schema":{"type":"boolean"},"description":"Store: true: real DTC brands only; false: everything else"},{"name":"own_stores","in":"query","schema":{"type":"boolean"},"description":"Store: runs its own physical stores"},{"name":"online_only","in":"query","schema":{"type":"boolean"},"description":"Store: site scan worked and found no physical stores"},{"name":"in_retailers","in":"query","schema":{"type":"boolean"},"description":"Store: sold through other retailers (stockists, wholesale)"},{"name":"tools","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: every one of these apps or technologies is installed (exact names)"},{"name":"gaps","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: every one of these tech gaps"},{"name":"signals","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has at least one signal of each kind (Pro and Scale)"},{"name":"signals_any","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has a signal of at least one of these kinds (Pro and Scale)"},{"name":"traits","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has every one of these standing store traits (open on every plan)"},{"name":"sells","in":"query","schema":{"type":"string"},"description":"Store: sells a product matching every one of these words (product title, type, tags or description)"},{"name":"min_followers","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: social followers at least, all networks together"},{"name":"category","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: store category, any of these (top-level e-commerce category, e.g. Apparel, Sports, Beauty & Fitness, Food & Drink, Home & Garden)"},{"name":"socials","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has a profile on every one of these networks"},{"name":"min_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: installed apps at least"},{"name":"max_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: installed apps at most"},{"name":"founder_found","in":"query","schema":{"type":"boolean"},"description":"Store: true: the owner or founder is among the people found"},{"name":"price_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: price tier: any of these (brand profile)"},{"name":"purchase_cycle","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: purchase cycle: any of these (brand profile)"},{"name":"audience_gender","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: audience: any of these (brand profile)"},{"name":"audience_life_stage","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: life stage: any of these (brand profile)"},{"name":"sales_model","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: sales model: any of these (brand profile)"},{"name":"channels","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: channels: any of these (brand profile)"},{"name":"regulated","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: regulated: any of these (brand profile)"},{"name":"seasonality","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: seasonality: any of these (brand profile)"},{"name":"best_fit_vendors","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: best-fit vendors: any of these (brand profile)"},{"name":"seniority","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these levels: owner_founder, c_suite, vp, head_director, manager, other"},{"name":"department","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these departments (the broad list)"},{"name":"departments","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these departments from the finer list of about 30 (sales apart from wholesale, founders and owners, ecommerce, retention …); the keys are in GET /api/v1 under departments"},{"name":"title","in":"query","schema":{"type":"string"},"description":"Title holds every one of these words"},{"name":"titles","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Title holds any one of these phrases, e.g. founder, head of ecommerce, VP marketing (up to 25)"},{"name":"exclude_titles","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Leave out titles holding any of these phrases, e.g. assistant, intern (up to 25)"},{"name":"location","in":"query","schema":{"type":"string"},"description":"Location holds this text (city, region or country)"},{"name":"person_country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Where the person is, ISO code (US, GB, CA …)"},{"name":"dm","in":"query","schema":{"type":"boolean"},"description":"Decision-makers only"},{"name":"has_email","in":"query","schema":{"type":"boolean"},"description":"Has a work email"},{"name":"email_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Email checked by a verifier (verified) or catch-all and not confirmed (unconfirmed)"},{"name":"has_mobile","in":"query","schema":{"type":"boolean"},"description":"Has a mobile number"},{"name":"has_direct","in":"query","schema":{"type":"boolean"},"description":"Has a direct dial"},{"name":"has_linkedin","in":"query","schema":{"type":"boolean"},"description":"Has a LinkedIn profile"},{"name":"started_within_days","in":"query","schema":{"type":"integer","minimum":0},"description":"Started the current role within this many days (Pro and Scale)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["seniority","name","store","role_start"]},"description":"seniority (default), name, store or role_start (newest first). Sorting reads the sample index."},{"name":"source","in":"query","schema":{"type":"string","enum":["live","sample"]},"description":"live (default): the live database; sample: the sample index. Filters with no live equivalent read the sample and say so."},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":0},"description":"Rows per page, 1-50"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/people":{"get":{"operationId":"search_people_get","summary":"Free: never reveals a contact and never spends credits. Search people at AI-confirmed DTC stores in the live database: store filters plus seniority, department, titles (any of several, or leave some out), location, contact and role-start filters. Emails, phones and LinkedIn stay masked; each row says what can be unlocked.","security":[{"bearer":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Words in the name, title or store name"},{"name":"domains","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: exact store domains"},{"name":"vertical","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these verticals"},{"name":"band","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: monthly sales band"},{"name":"min_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: monthly sales at least, USD"},{"name":"max_sales","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: monthly sales at most, USD"},{"name":"platform","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these platforms"},{"name":"country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: any of these countries (ISO code)"},{"name":"dtc","in":"query","schema":{"type":"boolean"},"description":"Store: true: real DTC brands only; false: everything else"},{"name":"own_stores","in":"query","schema":{"type":"boolean"},"description":"Store: runs its own physical stores"},{"name":"online_only","in":"query","schema":{"type":"boolean"},"description":"Store: site scan worked and found no physical stores"},{"name":"in_retailers","in":"query","schema":{"type":"boolean"},"description":"Store: sold through other retailers (stockists, wholesale)"},{"name":"tools","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: every one of these apps or technologies is installed (exact names)"},{"name":"gaps","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: every one of these tech gaps"},{"name":"signals","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has at least one signal of each kind (Pro and Scale)"},{"name":"signals_any","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has a signal of at least one of these kinds (Pro and Scale)"},{"name":"traits","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has every one of these standing store traits (open on every plan)"},{"name":"sells","in":"query","schema":{"type":"string"},"description":"Store: sells a product matching every one of these words (product title, type, tags or description)"},{"name":"min_followers","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: social followers at least, all networks together"},{"name":"category","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: store category, any of these (top-level e-commerce category, e.g. Apparel, Sports, Beauty & Fitness, Food & Drink, Home & Garden)"},{"name":"socials","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: has a profile on every one of these networks"},{"name":"min_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: installed apps at least"},{"name":"max_apps","in":"query","schema":{"type":"integer","minimum":0},"description":"Store: installed apps at most"},{"name":"founder_found","in":"query","schema":{"type":"boolean"},"description":"Store: true: the owner or founder is among the people found"},{"name":"price_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: price tier: any of these (brand profile)"},{"name":"purchase_cycle","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: purchase cycle: any of these (brand profile)"},{"name":"audience_gender","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: audience: any of these (brand profile)"},{"name":"audience_life_stage","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: life stage: any of these (brand profile)"},{"name":"sales_model","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: sales model: any of these (brand profile)"},{"name":"channels","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: channels: any of these (brand profile)"},{"name":"regulated","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: regulated: any of these (brand profile)"},{"name":"seasonality","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: seasonality: any of these (brand profile)"},{"name":"best_fit_vendors","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store: best-fit vendors: any of these (brand profile)"},{"name":"seniority","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these levels: owner_founder, c_suite, vp, head_director, manager, other"},{"name":"department","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these departments (the broad list)"},{"name":"departments","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Any of these departments from the finer list of about 30 (sales apart from wholesale, founders and owners, ecommerce, retention …); the keys are in GET /api/v1 under departments"},{"name":"title","in":"query","schema":{"type":"string"},"description":"Title holds every one of these words"},{"name":"titles","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Title holds any one of these phrases, e.g. founder, head of ecommerce, VP marketing (up to 25)"},{"name":"exclude_titles","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Leave out titles holding any of these phrases, e.g. assistant, intern (up to 25)"},{"name":"location","in":"query","schema":{"type":"string"},"description":"Location holds this text (city, region or country)"},{"name":"person_country","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Where the person is, ISO code (US, GB, CA …)"},{"name":"dm","in":"query","schema":{"type":"boolean"},"description":"Decision-makers only"},{"name":"has_email","in":"query","schema":{"type":"boolean"},"description":"Has a work email"},{"name":"email_tier","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Email checked by a verifier (verified) or catch-all and not confirmed (unconfirmed)"},{"name":"has_mobile","in":"query","schema":{"type":"boolean"},"description":"Has a mobile number"},{"name":"has_direct","in":"query","schema":{"type":"boolean"},"description":"Has a direct dial"},{"name":"has_linkedin","in":"query","schema":{"type":"boolean"},"description":"Has a LinkedIn profile"},{"name":"started_within_days","in":"query","schema":{"type":"integer","minimum":0},"description":"Started the current role within this many days (Pro and Scale)"},{"name":"sort","in":"query","schema":{"type":"string","enum":["seniority","name","store","role_start"]},"description":"seniority (default), name, store or role_start (newest first). Sorting reads the sample index."},{"name":"source","in":"query","schema":{"type":"string","enum":["live","sample"]},"description":"live (default): the live database; sample: the sample index. Filters with no live equivalent read the sample and say so."},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":0},"description":"Rows per page, 1-50"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/products/search":{"get":{"operationId":"search_products_get","summary":"Free: never reveals a contact and never spends credits. Search the products stores sell: title, type, tags and description, every word must match. Public catalog data, open on every plan.","security":[{"bearer":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Every word appears in the product title, type, tags or description"},{"name":"domain","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Only these stores (exact domains)"},{"name":"vertical","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Store vertical"},{"name":"type","in":"query","schema":{"type":"string"},"description":"Product type, exact match ignoring case"},{"name":"page_size","in":"query","schema":{"type":"integer","minimum":0},"description":"Rows per page, 1-50"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous page"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}},"post":{"operationId":"search_products_post","summary":"Free: never reveals a contact and never spends credits. Search the products stores sell: title, type, tags and description, every word must match. Public catalog data, open on every plan.","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string"},"domain":{"type":"array","items":{"type":"string"}},"vertical":{"type":"array","items":{"type":"string","enum":["apparel_accessories","arts_crafts_hobbies","auto_vehicles","baby_kids_toys","beauty_personal_care","electronics_tech","food_beverage","general_merchandise","gifts_party_flowers","health_wellness","home_garden","industrial_business","not_applicable","other_products","pets","sports_outdoors"]}},"type":{"type":"string"},"page_size":{"type":"integer","minimum":0},"cursor":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/unlock/preview":{"post":{"operationId":"preview_unlock_post","summary":"Free: never reveals a contact and never spends credits. Before you spend: for each person id, which of email, phone and LinkedIn exist, which you already own, and the exact credit cost to unlock each kind.","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}},"kind":{"type":"string","enum":["name","email","phone","profile","full"]},"include_linkedin_only":{"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}},"get":{"operationId":"preview_unlock_get","summary":"Free: never reveals a contact and never spends credits. Before you spend: for each person id, which of email, phone and LinkedIn exist, which you already own, and the exact credit cost to unlock each kind.","security":[{"bearer":[]}],"parameters":[{"name":"ids","in":"query","schema":{"type":"string","description":"comma-separated"},"description":"Person ids from search_people or get_store, e.g. live:2:1758252"},{"name":"kind","in":"query","schema":{"type":"string","enum":["name","email","phone","profile","full"]},"description":"Only total this kind (optional)"},{"name":"include_linkedin_only","in":"query","schema":{"type":"boolean"},"description":"Count people with a LinkedIn profile but no email in the email cost"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/unlock":{"post":{"operationId":"unlock_contacts_post","summary":"The only call that spends credits. Unlock each id: email (2 credits) reveals the work email and LinkedIn together; phone (5) reveals the mobile or direct dial with the email and LinkedIn, less anything already paid for that person; name (1) shows the full name of someone with no contact on file; full (10) is for signal-based leads (their store has recorded signals) and reveals every contact plus the store's dated signals, less anything already paid for that person. Every unlock shows the full name. Charged once per person, only when it applies; anything you already unlocked is free. kind=email skips people with a LinkedIn profile but no email, unless include_linkedin_only is true. Run preview_unlock first to see the cost.","security":[{"bearer":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}},"kind":{"type":"string","enum":["name","email","phone","profile","full"]},"include_linkedin_only":{"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/signals":{"get":{"operationId":"list_signals_get","summary":"Signals that fit your company. Pro and Scale get every dated signal with its store; other plans get counts per kind.","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/fit":{"get":{"operationId":"get_fit_get","summary":"Your company, the buyer type we read from your site, and how many stores and decision-makers fit.","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/export":{"get":{"operationId":"export_unlocked_get","summary":"Every person this account has unlocked. Follow next_cursor when the answer says partial.","security":[{"bearer":[]}],"parameters":[{"name":"cursor","in":"query","schema":{"type":"string"},"description":"next_cursor from the previous answer"}],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}},"/api/v1/account":{"get":{"operationId":"account_get","summary":"Plan, credits and whether signals are open.","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Bad filter"},"401":{"description":"invalid_api_key"},"402":{"description":"insufficient_credits"},"429":{"description":"rate_limited"}}}}}}