Scrape Foursquare with AI

# Scrape Foursquare — SoloStack Skill File
> Drop this file into your SoloStack repo and Claude Code will use it as
> context to run this workflow automatically.
---
## Overview
Extract Foursquare venue data, tips, ratings, and location intelligence using Apify and Claude Code.
**Apify Actor:** `apify/foursquare-scraper`
**Pricing:** ~$0.30 per 1,000 venues
## Capabilities
1. **Venue Data** — Extract venue name, address, category, rating, check-in count, photos, and contact info.
2. **User Tips** — Pull tips and reviews with text, likes, and timestamp from venue pages.
3. **Category Search** — Search venues by category (restaurants, offices, gyms) within any geographic radius.
4. **Photo Extraction** — Access venue photos with upload dates and user attribution.
5. **Location Intelligence** — Get coordinates, city, state, and neighborhood data for every venue.
## Pipeline
1. **Define targets** — Specify Foursquare URLs, search terms, or categories to scrape
2. **Run scraper** — Apify actor extracts data, handles pagination and rate limits automatically
3. **Process data** — Clean, deduplicate, and enrich the raw output for analysis
4. **Load into CRM** — Push structured data into Neon database with source attribution
## Use Cases
- **Location-based lead gen:** Find businesses by type and location — gyms, restaurants, offices — with contact info and popularity data for outreach targeting.
- **Competitive venue analysis:** Compare your location ratings against competitors in the same area. Track check-in volume as a foot traffic proxy.
- **Market expansion research:** Analyze venue density and ratings by city to identify promising markets for physical business expansion.
- **Local SEO research:** Foursquare data feeds Apple Maps and other platforms. Understanding Foursquare rankings helps with local discovery optimization.
## Warnings
- Foursquare has migrated much of its consumer data to Swarm. Some venue data may be less current than Google Maps.
- Check-in counts reflect historical Foursquare/Swarm usage — not current foot traffic.
- Foursquare venue photos may require attribution under their licensing terms.
## Sample Output
```json
{
  "venueId": "4b7e5c9af964a520e73c30e3",
  "name": "The Productive Space",
  "category": "Coworking Space",
  "rating": 8.7,
  "checkIns": 3456,
  "address": "456 Tech Ave, Austin, TX",
  "tips": 89,
  "photos": 234,
  "lat": 30.2672,
  "lng": -97.7431
}
```
Download the complete skill file with full implementation details,
agent prompts, and ready-to-run scripts.