> ## Documentation Index > Fetch the complete documentation index at: /docs/llms.txt > Use this file to discover all available pages before exploring further. # Read the seller's competitors and their readiness scores > The seller's competitors from its newest competitor scan that named any, each with its state: unscored (named, never run), scoring (its agent run under way), scored, or not_scored (it blocks agents, or too little was measured; null score and a note). Each was given the seller's ZeroClick Readiness Report goal by one agent and graded the same way. Scored best first, then not scored, then scoring and unscored. Empty, with naming true, while the first names are being found. ## OpenAPI ````yaml https://api.zeroclick.io/openapi.json get /v1/sellers/{sellerId}/competitors openapi: 3.0.0 info: title: ZeroClick API description: >- REST API for managing ZeroClick sellers, services, pricing, usage, and analytics. Authenticate with an API key from the ZeroClick dashboard. version: 1.0.0 servers: - url: https://api.zeroclick.io security: - bearerAuth: [] tags: - name: API keys - name: Sellers - name: Services - name: Meters - name: Plans - name: Plan meter prices - name: Usage - name: Analytics - name: Agentify - name: Stripe Connect - name: Sandbox - name: Organizations - name: Users paths: /v1/sellers/{sellerId}/competitors: get: tags: - Sellers summary: Read the seller's competitors and their readiness scores description: >- The seller's competitors from its newest competitor scan that named any, each with its state: unscored (named, never run), scoring (its agent run under way), scored, or not_scored (it blocks agents, or too little was measured; null score and a note). Each was given the seller's ZeroClick Readiness Report goal by one agent and graded the same way. Scored best first, then not scored, then scoring and unscored. Empty, with naming true, while the first names are being found. parameters: - schema: type: string minLength: 1 in: path name: sellerId required: true responses: '200': description: Default Response content: application/json: schema: type: object properties: competitors: type: array items: type: object properties: domain: type: string name: type: string why: type: string state: type: string enum: - unscored - scoring - scored - not_scored score: nullable: true type: number tier: nullable: true type: string note: nullable: true type: string required: - domain - name - why - state - score - tier - note additionalProperties: false scannedAt: nullable: true type: string naming: type: boolean required: - competitors - scannedAt - naming additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: error: type: string enum: - organization_required - organization_permission_required - seller_not_found - service_not_found - meter_not_found - plan_not_found - plan_meter_price_not_found - duplicate_slug - duplicate_key - duplicate_plan_meter_price - duplicate_free_trial - signing_secret_not_found - insufficient_scope - payg_price_not_whole_cents - custom_domain_skip_unavailable - active_stateful_accounts_exist - free_trial_price_not_zero - free_trial_interval_not_none - included_credit_units_incomplete - included_credit_units_without_credit - claim_cap_requires_free_trial - maximum_purchase_below_minimum - buy_with_ai_not_available - auto_renew_incompatible_plan - auto_top_up_incompatible_plan - self_serve_onboarding_not_enabled - build_not_started - logo_unreachable - logo_unsupported_format - logo_too_large - logo_not_square - logo_too_small required: - error additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: error: type: string enum: - organization_required - organization_permission_required - seller_not_found - service_not_found - meter_not_found - plan_not_found - plan_meter_price_not_found - duplicate_slug - duplicate_key - duplicate_plan_meter_price - duplicate_free_trial - signing_secret_not_found - insufficient_scope - payg_price_not_whole_cents - custom_domain_skip_unavailable - active_stateful_accounts_exist - free_trial_price_not_zero - free_trial_interval_not_none - included_credit_units_incomplete - included_credit_units_without_credit - claim_cap_requires_free_trial - maximum_purchase_below_minimum - buy_with_ai_not_available - auto_renew_incompatible_plan - auto_top_up_incompatible_plan - self_serve_onboarding_not_enabled - build_not_started - logo_unreachable - logo_unsupported_format - logo_too_large - logo_not_square - logo_too_small required: - error additionalProperties: false '409': description: Default Response content: application/json: schema: type: object properties: error: type: string enum: - organization_required - organization_permission_required - seller_not_found - service_not_found - meter_not_found - plan_not_found - plan_meter_price_not_found - duplicate_slug - duplicate_key - duplicate_plan_meter_price - duplicate_free_trial - signing_secret_not_found - insufficient_scope - payg_price_not_whole_cents - custom_domain_skip_unavailable - active_stateful_accounts_exist - free_trial_price_not_zero - free_trial_interval_not_none - included_credit_units_incomplete - included_credit_units_without_credit - claim_cap_requires_free_trial - maximum_purchase_below_minimum - buy_with_ai_not_available - auto_renew_incompatible_plan - auto_top_up_incompatible_plan - self_serve_onboarding_not_enabled - build_not_started - logo_unreachable - logo_unsupported_format - logo_too_large - logo_not_square - logo_too_small required: - error additionalProperties: false '422': description: Default Response content: application/json: schema: type: object properties: error: type: string enum: - organization_required - organization_permission_required - seller_not_found - service_not_found - meter_not_found - plan_not_found - plan_meter_price_not_found - duplicate_slug - duplicate_key - duplicate_plan_meter_price - duplicate_free_trial - signing_secret_not_found - insufficient_scope - payg_price_not_whole_cents - custom_domain_skip_unavailable - active_stateful_accounts_exist - free_trial_price_not_zero - free_trial_interval_not_none - included_credit_units_incomplete - included_credit_units_without_credit - claim_cap_requires_free_trial - maximum_purchase_below_minimum - buy_with_ai_not_available - auto_renew_incompatible_plan - auto_top_up_incompatible_plan - self_serve_onboarding_not_enabled - build_not_started - logo_unreachable - logo_unsupported_format - logo_too_large - logo_not_square - logo_too_small required: - error additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key created in the ZeroClick dashboard under Settings → API keys. Keys start with `zc_`. Send them as `Authorization: Bearer zc_...`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.