Autocomplete Name Extraction

This project extracts all possible names from the autocomplete API by systematically querying prefixes and handling constraints like rate limits and proxy settings.

Features

• Supports three API versions: v1, v2, and v3
• Uses a systematic approach to extract names efficiently
• Implements retries and error handling for stability
• Supports proxy configuration for restricted networks
• Saves results to text files for further analysis

Prerequisites

• Python 3.x
• requests library (pip install requests)

Setup

1. Clone the repository or download the script.
2. Install dependencies:

   pip install requests

Usage

Run the script to start extraction:

python v1.py
python v2.py
python v3.py

API Insights

The autocomplete API provides name suggestions based on the given query prefix. The behavior varies across versions:

• Version 1 (v1): Returns a maximum of 10 results per query. Using three-letter prefixes (aaa to zzz) ensures complete coverage.
• Version 2 (v2): Results contain numbers, and prefixes must be explored recursively as they do not always follow strict alphabetical order.
• Version 3 (v3): Supports special characters like +, ., and -. Queries need to be dynamically expanded based on discovered patterns.

Extraction Logic

Version 1 (v1)

• Uses all three-letter prefixes (aaa to zzz) to ensure complete coverage.

Version 2 (v2)

• Uses recursive exploration, expanding only if results are found.

Version 3 (v3)

• Includes special characters and expands on prefixes dynamically.

Output

The extracted names are saved in respective text files:

• v1_names.txt
• v2_names.txt
• v3_names.txt

Troubleshooting

• 407 Proxy Authentication Required: Ensure proxy settings are correctly configured.
• 429 Rate Limit Exceeded: The script automatically retries after a delay.
• Timeout Errors: Check network connectivity and increase timeout values if needed.