# Ge0rg3/requests-ip-rotator

A Python library to utilize AWS API Gateway's large IP pool as a proxy to generate pseudo-infinite IPs for web scraping and brute forcing.

Repository: https://github.com/Ge0rg3/requests-ip-rotator
Canonical: https://ross.abutalabs.com/products/requests-ip-rotator
Homepage: https://pypi.org/project/requests-ip-rotator/
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: security-tools, security, ip, bypass, networking, aws, apigateway, bugbounty, web-security, hacktoberfest
Last push: 2026-07-13T23:09:36+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 81, longevity 100
- inputs: {"age_days": 1873, "days_push": 51, "days_rel": 129, "gap_med": 0, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1675, forks 172 (observed 2026-08-28T04:05:20.456221+00:00)

## What it is
A Python library that mounts AWS API Gateway as a proxy onto requests sessions, rotating source IPs on every request using AWS's large IP pool. It is aimed at bypassing IP-based rate limits for web scraping and brute forcing, with automatic X-Forwarded-For randomization.

## Use cases
- rotate IP addresses for web scraping
- bypass IP-based rate limits on a site
- send requests from different IPs each time
- distribute brute force requests across many IPs
- avoid getting blocked while crawling a website
- use AWS API Gateway as a free-tier proxy

## When to choose
- you already have an AWS account and want pseudo-infinite rotating IPs
- you use Python requests and want drop-in IP rotation via session mounting
- you need to bypass per-IP rate limits during scraping or bug bounty work
- request volume fits within AWS API Gateway's free tier

## When to avoid
- you need anonymity from AWS itself, since requests carry identifiable AWS headers like X-Amzn-Trace-Id
- your target blocks AWS IP ranges or API Gateway traffic
- you cannot manage AWS credentials or risk API Gateway charges
- you need high-volume scraping beyond the free tier without budget for ~$3 per million requests

## Facets
- artifact type: library
- maturity: active
- function: http-client, proxy, web-scraping, security
- domain: security, web-development, developer-tools, crawlers
- platform: python, cloud, cross-platform
- tags: ip-rotation, aws-api-gateway, rate-limit-bypass, requests, bugbounty, brute-force

## Member repositories
- Ge0rg3/requests-ip-rotator (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:20.456221+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:42:28.188883+00:00, confidence not recorded.
  - readme: https://github.com/Ge0rg3/requests-ip-rotator (fetched 2026-08-28T04:05:20.456221+00:00, sha 18491fe2d251)
  - homepage: https://pypi.org/project/requests-ip-rotator/ (fetched 2026-08-29T11:15:16.215462+00:00, sha 4b4e8fead74a)
  - registry_pypi: https://pypi.org/pypi/requests-ip-rotator/json (fetched 2026-08-29T11:15:16.224332+00:00, sha 2e83a6b44612)
- Data as of 2026-08-30T08:39:29.467469+00:00.