> ## Documentation Index > Fetch the complete documentation index at: https://www.vollna.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get niche difficulty > Returns how hard a niche is to win, from Upwork's own counts over the last 180 days: average applicants per job, interview rate, fill rate and a 0 to 100 difficulty. Takes the same scope as GET /market-insights. Counts against the daily niche_difficulty cap ## OpenAPI ````yaml get /market-insights/niche-difficulty openapi: 3.0.4 info: title: Vollna API description: API for managing Upwork profiles, proposals, results, and filters version: 1.0.0 servers: - url: https://api.vollna.com/v1 security: [] tags: - name: Profiles description: Manage Upwork profiles - name: Proposals description: Access and manage Upwork proposals - name: Results description: View monitoring results and projects - name: Filters description: Manage monitoring filters - name: Auto Bidding description: Manage auto bidding jobs and setups - name: Account description: The token team's account, plan and meters - name: Invitations description: Upwork invitations - name: Projects description: Upwork jobs and their competition - name: AI Qualifier description: A filter's AI qualifier and its verdicts - name: Market Insights description: Upwork market analytics and saved searches - name: Proposal Templates description: Proposal templates and their results paths: /market-insights/niche-difficulty: get: tags: - Market Insights summary: Get niche difficulty description: >- Returns how hard a niche is to win, from Upwork's own counts over the last 180 days: average applicants per job, interview rate, fill rate and a 0 to 100 difficulty. Takes the same scope as GET /market-insights. Counts against the daily niche_difficulty cap parameters: - name: filterId in: query required: false description: Scope to one of your filters schema: type: integer - name: keywords in: query required: false description: Keywords to match schema: type: string maxLength: 200 - name: categoryIds in: query required: false description: >- Upwork category ids, comma-separated (12,40) or repeated (categoryIds[]=12) schema: type: string - name: hourlyRateMin in: query required: false description: Minimum hourly rate schema: type: number - name: hourlyRateMax in: query required: false description: Maximum hourly rate schema: type: number - name: fixedBudgetMin in: query required: false description: Minimum fixed budget schema: type: number - name: fixedBudgetMax in: query required: false description: Maximum fixed budget schema: type: number - name: experienceLevels in: query required: false description: 'Comma-separated: 1 entry, 2 intermediate, 3 expert' schema: type: string - name: verifiedOnly in: query required: false description: Only clients with a verified payment method schema: type: boolean default: false - name: searchIn in: query required: false description: >- Comma-separated fields the keywords match: title, description, skills. All three when left out schema: type: string responses: '200': description: Successful operation content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/NicheDifficulty' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': description: This part of Market Insights is on paid plans only content: application/json: schema: $ref: '#/components/schemas/ServiceError' '404': $ref: '#/components/responses/NotFound' '429': description: >- The daily niche_difficulty cap is used up, or the rate limit is reached content: application/json: schema: $ref: '#/components/schemas/ServiceError' security: - apiToken: [] components: schemas: NicheDifficulty: type: object description: >- How hard a niche is to win, from Upwork's own counts over the last 180 days properties: available: type: boolean description: >- false when fewer than 20 jobs in the scope have activity data over the last 180 days reason: type: string description: Why the figures are missing; only when available is false jobs: type: integer description: Jobs with activity data in the scope avgApplicants: type: number interviewRatePct: type: number fillRatePct: type: number difficulty: type: integer description: 0 to 100; higher is harder to win minimum: 0 maximum: 100 crowding: type: integer odds: type: integer reliability: type: integer ServiceError: type: object properties: error: type: string description: Short error title example: Validation failed message: type: string description: What went wrong and what to send instead, written for the user fields: type: object description: >- Per-field messages keyed by dot path, when several fields fail at once additionalProperties: type: string Error: type: object properties: error: type: string responses: BadRequest: description: >- Invalid request. message says what to send instead; fields names each invalid field content: application/json: schema: $ref: '#/components/schemas/ServiceError' Unauthorized: description: Missing or unknown API token content: application/json: schema: $ref: '#/components/schemas/Error' PaymentRequired: description: The team's subscription is not active content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: Not found in the token's team content: application/json: schema: $ref: '#/components/schemas/ServiceError' securitySchemes: apiToken: type: apiKey name: X-API-TOKEN in: header description: API token for authentication ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.