> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proxyscrape.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get proxy list

> Returns a list of free proxies. Use query parameters to filter by protocol, country, timeout, anonymity, and more. Results can be displayed in the browser or returned for download.



## OpenAPI

````yaml /openapi-public.json get /v4/free-proxy-list/get
openapi: 3.0.3
info:
  title: ProxyScrape Public API
  description: Free proxy list — no authentication required.
  version: 1.0.0
servers:
  - url: https://api.proxyscrape.com
    description: ProxyScrape API
security: []
tags:
  - name: Public API
    description: Free proxy list — no authentication required
paths:
  /v4/free-proxy-list/get:
    get:
      tags:
        - Public API
      summary: Get proxy list
      description: >-
        Returns a list of free proxies. Use query parameters to filter by
        protocol, country, timeout, anonymity, and more. Results can be
        displayed in the browser or returned for download.
      operationId: getFreeProxyList
      parameters:
        - name: request
          in: query
          required: true
          schema:
            type: string
            enum:
              - displayproxies
              - getproxies
              - proxyinfo
          description: >-
            `displayproxies` — show list in browser; `getproxies` — download
            list; `proxyinfo` — return metadata (count, last update, countries,
            etc.). Use optional `simplified=true` with `proxyinfo` for count
            only.
        - name: protocol
          in: query
          schema:
            type: string
            enum:
              - http
              - socks4
              - socks5
              - all
            default: all
          description: >-
            Protocol: `http`, `socks4`, `socks5`, or `all`. For multiple:
            `socks4,socks5`
        - name: timeout
          in: query
          schema:
            type: integer
            default: 10000
          description: Maximum proxy timeout in milliseconds
        - name: country
          in: query
          schema:
            type: string
            default: all
          description: 'Alpha-2 ISO country code or `all`. Multiple: comma-separated'
        - name: ssl
          in: query
          schema:
            type: string
            enum:
              - all
              - 'yes'
              - 'no'
            default: all
          description: 'HTTPS support. Only for HTTP proxies: `all`, `yes`, or `no`'
        - name: anonymity
          in: query
          schema:
            type: string
            enum:
              - elite
              - anonymous
              - transparent
              - all
            default: all
          description: 'Anonymity level (HTTP only). Multiple: comma-separated'
        - name: skip
          in: query
          schema:
            type: integer
            default: 0
          description: Number of records to skip (pagination)
        - name: limit
          in: query
          schema:
            type: integer
            default: 2000
            maximum: 2000
          description: Maximum number of records to return (max 2000)
        - name: simplified
          in: query
          schema:
            type: boolean
          description: >-
            Only when request=proxyinfo: set to true to get only the count of
            available proxies
      responses:
        '200':
          description: Proxy list (displayproxies/getproxies) or metadata (proxyinfo)

````