read

Returns potential winning products discovered by the research pipeline. Each candidate has a score, signals (ad duration

Returns potential winning products discovered by the research pipeline. Each candidate has a score, signals (ad duration, cross-store count, review velocity), and a status. Use when the user asks about new product opportunities, research results, or what products to onboard next.

post/api/v1/tools/get_research_candidates

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/get_research_candidates
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: research:read)

Request body

status'discovered' | 'vetting' | 'approved' | 'onboarding' | 'onboarded' | 'rejected' | 'expired'

Optional: filter by candidate status. Omit to see all active candidates.

limitinteger

Max candidates to return (default 10, max 30).

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.