{"openapi":"3.1.0","info":{"title":"LeadPaca - Project Lead Discovery","description":"LeadPaca finds concrete project leads in a niche industry in Japan, China or overseas markets and tells you who to contact. It mines social-media posts and comment sections for parties that reveal a commercial role (sellers, buyers, equipment demand, EPC, land owners), cross-checks every extracted lead against the source text, flags hub accounts and pasted advertisements, and merges projects from public news and procurement notices into project cards with owner, designer, EPC, voltage, stage and tier. lead generation, project sourcing, B2B leads, deal sourcing, 案件発掘, 系統用蓄電池, 项目线索, 储能, 数据中心, switchgear, 开关柜.","contact":{"name":"LeadPaca","url":"https://leads-api-586747566167.asia-northeast1.run.app/","email":"hello@alpaca-army.com"},"license":{"name":"Proprietary"},"version":"0.2.0","x-guidance":"Finds concrete project leads and who to contact, for a niche industry in Japan, China or overseas markets. POST /v1/leads/scan with JSON {pack_id, caller_role?, niche?, public_terms?}; returns 202 {task_id}. A domain pack (GET /v1/leads/packs) carries one market's vocabulary, search seeds and news terms. Payment is settled only when your scan succeeds; a failed task is never charged. Poll GET /v1/leads/tasks/{task_id} until status=succeeded (typically 1-3 min), then GET /v1/leads/tasks/{task_id}/result. The result lists `leads`: social-media accounts that revealed a commercial role in a post or comment (seller_developer, buyer_investor, equipment_demand, supplier_epc, land_owner, price_inquirer) with region/capacity/timeline/budget when stated, a verbatim evidence quote, the post URL, two independent scores (strength, reachability) each with rationale, and `contact_paths` ordered fastest first. `status=verified` means the extraction was checked against the source text; `needs_human` means rule-based only. A pack may keep only certain roles and a scale band; candidates it leaves out are listed under `excluded`, and ones whose scale could not be confirmed under `scale_unknown`. `public_projects` lists projects from news and procurement notices, merged across sources, with a project fingerprint (owner, voltage, designer, EPC, procurement mode), stage, grouped signals and a tier (S/A); `watchlist` holds projects with too few signals yet. `cards` renders everything as readable field:value cards. Set `caller_role` so your counterparties sort first. Always read `coverage_gaps` and `needs_input`: the service states what it could not check instead of guessing. Cheap probe first: POST /v1/leads/preview returns public projects only. Contact data is limited to what accounts published themselves; use it for legitimate business outreach.","x-logo":{"url":"https://leads-api-586747566167.asia-northeast1.run.app/logo.png","altText":"LeadPaca"}},"paths":{"/v1/leads/packs":{"get":{"summary":"List available domain packs","operationId":"packs_v1_leads_packs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Packs V1 Leads Packs Get"}}}}}}},"/v1/leads/sources":{"get":{"summary":"Connected data sources and reserved slots","operationId":"sources_v1_leads_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sources V1 Leads Sources Get"}}}}}}},"/v1/health":{"get":{"summary":"Health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Health Get"}}}}}}},"/v1/leads/scan":{"post":{"summary":"Scan a niche for project leads and contact paths","description":"Async. Mines social-media comments and public news; returns a task id to poll.","operationId":"scan_v1_leads_scan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanBody"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Scan V1 Leads Scan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"amount":"2.00","currency":"USD"},"protocols":{"x402":{"scheme":"exact","asset":"USDC","networks":["eip155:8453","eip155:5042","eip155:137"],"payTo":"0x9099f2275875d2a56772f0158f36c9e42073e0e0","header":"Payment-Signature (x402 v2) or X-PAYMENT (v1)"}}}}},"/v1/leads/preview":{"post":{"summary":"Public-source project probe","description":"Sync. Named projects from public news only; no social-media mining, no LLM.","operationId":"preview_v1_leads_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Preview V1 Leads Preview Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"amount":"0.05","currency":"USD"},"protocols":{"x402":{"scheme":"exact","asset":"USDC","networks":["eip155:8453","eip155:5042","eip155:137"],"payTo":"0x9099f2275875d2a56772f0158f36c9e42073e0e0","header":"Payment-Signature (x402 v2) or X-PAYMENT (v1)"}}}}},"/v1/leads/tasks/{task_id}":{"get":{"summary":"Task status","operationId":"task_status_v1_leads_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Task Status V1 Leads Tasks  Task Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/leads/tasks/{task_id}/result":{"get":{"summary":"Full scan result","operationId":"task_result_v1_leads_tasks__task_id__result_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Task Result V1 Leads Tasks  Task Id  Result Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ScanBody":{"properties":{"pack_id":{"type":"string","pattern":"^[a-z0-9_]{3,40}$","title":"Pack Id","description":"Domain pack to use (see GET /v1/leads/packs). A pack carries the market's vocabulary, seed keywords, accounts to follow and public news terms.","default":"japan_grid_storage"},"niche":{"type":"string","maxLength":60,"title":"Niche","description":"Industry niche as practitioners write it on Chinese social media. Space-separated words must ALL appear in a post for it to count as relevant. Optional: leave empty to use the pack's own terms.","default":"","examples":["日本 储能","数据中心 液冷"]},"country":{"anyOf":[{"type":"string","enum":["JP","CN"]},{"type":"null"}],"title":"Country","description":"Locale for ad-hoc public_terms. Ignored when the pack's own news sources are used."},"public_terms":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Public Terms","description":"Official local-language term(s) for public news search. Strongly recommended.","examples":[["系統用蓄電池"],["储能电站"]]},"sns_keywords":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Sns Keywords","description":"Override the social-media seed keywords. Default: niche plus 项目/合作/转让/投资."},"caller_role":{"anyOf":[{"type":"string","enum":["buyer_investor","seller_developer","supplier_epc","land_owner"]},{"type":"null"}],"title":"Caller Role","description":"Your own role. Leads who are your counterparties are flagged and sorted first."},"window_days":{"type":"integer","maximum":365.0,"minimum":7.0,"title":"Window Days","description":"Look-back window for public news, in days.","default":90},"platforms":{"items":{"type":"string","enum":["xhs","douyin"]},"type":"array","title":"Platforms","description":"Social platforms to mine. Douyin costs more per search and is noisier; opt in when needed."}},"additionalProperties":false,"type":"object","title":"ScanBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"externalDocs":{"url":"https://leads-api-586747566167.asia-northeast1.run.app/docs","description":"Interactive API docs (Swagger UI)"}}