Troubleshooting

​

Instagram Scraping Issues

​

Authentication Errors

Login error: Challenge required
HTTP Error 401: Unauthorized

1. Login with Instagram credentials:
   import instaloader
   
   L = instaloader.Instaloader()
   L.login('your_username', 'your_password')
   
2. Use session file:
   • Login once and save session
   • Reuse session to avoid repeated logins
   L.load_session_from_file('your_username')
   
3. Check Instagram restrictions:
   • Instagram may limit API access
   • Try again after a few hours
   • Consider using a different account

​

Rate Limiting

Rate limit exceeded
Too many requests
429 Error

1. Add delays between requests:
   import time
   
   for post in profile.get_posts():
       if post.is_video:
           # Process post
           time.sleep(2)  # Wait 2 seconds between posts
   
2. Reduce request frequency:
   • Scrape in smaller batches
   • Run during off-peak hours
   • Spread scraping across multiple sessions
3. Use Instaloader’s built-in rate limiting:
   L = instaloader.Instaloader(
       sleep=True,  # Sleep between requests
       quiet=False,  # Show progress
       user_agent='Mozilla/5.0',
       max_connection_attempts=3
   )
   

​

Missing Video Data

• url_video shows “Sin URL”
• duracion_video shows “No disponible”

1. Verify post type:
   if post.is_video and post.video_url:
       url_video = post.video_url
   else:
       url_video = "Sin URL"
   
2. Handle private or expired content:
   • Some videos may be deleted or made private
   • Add error handling:
   try:
       url_video = post.video_url
   except Exception as e:
       print(f"Error getting video URL: {e}")
       url_video = "Sin URL"
   

​

Map Generation Issues

​

Coordinate Parsing Errors

Error al procesar la ubicación: invalid literal for float()

1. Check coordinate format:
   • Must be: "latitude,longitude"
   • Example: "28.1234,-15.5678"
   • No spaces, comma-separated
2. Validate data before processing:
   def obtener_coordenadas(localizacion):
       try:
           if pd.isna(localizacion):
               return None, None
           lat, lon = map(float, str(localizacion).split(','))
           return lat, lon
       except Exception as e:
           print(f"Error: {localizacion} - {e}")
           return None, None
   
3. Clean Excel data:
   • Remove extra spaces
   • Check for invalid characters
   • Ensure numeric values

​

Image Download Failures

No se pudo descargar la imagen
HTTP Error 404

1. Check image URLs:
   • Verify URLs are valid and accessible
   • Instagram CDN links may expire
2. Add retry logic:
   import time
   
   def descargar_imagen(url, index, max_retries=3):
       for attempt in range(max_retries):
           try:
               response = requests.get(url, stream=True, timeout=10)
               if response.status_code == 200:
                   ruta_imagen = f"imagenes/imagen_{index}.jpg"
                   with open(ruta_imagen, 'wb') as file:
                       for chunk in response.iter_content(1024):
                           file.write(chunk)
                   return ruta_imagen
           except Exception as e:
               print(f"Attempt {attempt + 1} failed: {e}")
               time.sleep(2)
       return None
   
3. Use fallback images:
   • Provide a default placeholder image
   • Skip markers without images

​

Map Not Loading

• Blank page
• JavaScript console errors

1. Check file paths:
   • Ensure imagenes/ folder is in the same directory as HTML
   • Use relative paths for images
2. Verify Folium installation:
   pip install --upgrade folium
   
3. Test with simple map:
   import folium
   
   m = folium.Map(location=[28.0, -15.0], zoom_start=6)
   m.save("test_map.html")
   

​

Dependency Issues

​

Missing Package Errors

ModuleNotFoundError: No module named 'instaloader'
ImportError: cannot import name 'xxx'

1. Install all requirements:
   pip install instaloader pandas folium requests matplotlib seaborn plotly openpyxl
   
2. Use virtual environment:
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   
3. Check Python version:
   python --version  # Should be 3.8 or higher
   

​

Excel File Reading Errors

ImportError: Missing optional dependency 'openpyxl'

1. Install openpyxl:
   pip install openpyxl
   
2. Alternative - convert to CSV:
   # Read CSV instead
   df = pd.read_csv('data.csv')
   

​

Data Analysis Issues

​

Jupyter Notebook Not Starting

1. Install Jupyter:
   pip install jupyter notebook
   jupyter notebook
   
2. Use JupyterLab:
   pip install jupyterlab
   jupyter lab
   
3. Use VS Code:
   • Install Python extension
   • Open .ipynb files directly

​

Plotting Errors

1. Enable inline plotting:
   %matplotlib inline
   
2. Update plotting libraries:
   pip install --upgrade matplotlib seaborn plotly
   
3. Check backend:
   import matplotlib
   matplotlib.use('Agg')  # For non-interactive backend
   

​

Performance Issues

​

Slow Scraping

1. Limit post count:
   from itertools import islice
   
   posts = islice(profile.get_posts(), 100)  # Only first 100 posts
   
2. Skip non-video posts early:
   for post in profile.get_posts():
       if not post.is_video:
           continue
       # Process only videos
   
3. Use multiprocessing:
   • Process multiple posts in parallel (advanced)
   • Be careful with rate limits

​

Large File Sizes

1. Compress images:
   from PIL import Image
   
   img = Image.open(ruta_imagen)
   img.save(ruta_imagen, quality=70, optimize=True)
   
2. Limit data:
   • Filter by date range
   • Select top N posts
   • Remove unnecessary columns
3. Use external image hosting:
   • Link to Instagram URLs directly
   • Don’t download thumbnails locally

​

Getting Help

1. Check documentation:
   • Instaloader Docs
   • Folium Documentation
   • Pandas Documentation
2. Search existing issues:
   • GitHub Issues for each library
   • Stack Overflow
3. Enable debug logging:
   import logging
   logging.basicConfig(level=logging.DEBUG)