Foursquare

{
  "service_type": "platform",
  "base_url": "https://developer.foursquare.com",
  "auth_method": "oauth2",
  "auth_config": {
    "oauth2": {
      "auth_url": "https://foursquare.com/oauth2/authenticate",
      "token_url": "https://foursquare.com/oauth2/access_token",
      "scopes": ["public", "users", "venues", "photos", "tips", "lists", "events"],
      "grant_type": "authorization_code"
    }
  },
  "endpoints": [],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Limited API credits for testing and low-volume use",
      "paid_tiers": ["Standard", "Advanced"],
      "pricing_page": "https://developer.foursquare.com/docs/places/faq#pricing"
    }
  },
  "rate_limits": {
    "free_tier": "50 requests per second per app, 500,000 API credits per month",
    "paid_tiers": "Higher credits and rate limits, see pricing page"
  },
  "capabilities": [
    "Place search and discovery",
    "Place details (hours, ratings, photos, tips)",
    "Geolocation-based checkins and user history",
    "User profile and friend data",
    "Photos and tips creation and retrieval",
    "Events and lists",
    "Venue analytics and engagement metrics",
    "Places API (formerly Venues API)",
    "Pilgrim SDK for automatic place detection",
    "Real-time checkins via webhooks"
  ],
  "raw_analysis": "Foursquare is a mature location-based social networking platform that now focuses on its Places API for developers. It provides geolocation data for millions of places worldwide, enabling apps to integrate place search, details, check-ins, user-generated content, and analytics. The platform was originally a consumer check-in app but pivoted to enterprise location intelligence with products like Foursquare (consumer) and Foursquare Places API. The developer portal offers comprehensive documentation, a console for testing, and SDKs (Pilgrim) for mobile integrations. Authentication uses OAuth 2.0. Pricing follows a freemium model with a free tier for low-volume use and paid tiers for scaling. The API is widely used in location-based services, travel, and mobile apps. The platform is robust but has limited endpoints compared to broad SaaS platforms; however, it is specialized and performs well for place data."
}

1/3 tests passed

```json
{
  "overall": 42,
  "dimensions": {
    "token_efficiency": 4.0,
    "first_try_success": 3.0,
    "response_parseability": 8.0,
    "error_clarity": 3.0,
    "doc_quality": 5.0,
    "auth_simplicity": 2.0,
    "latency": 8.0,
    "consistency": 4.0
  },
  "pricing_normalized": {
    "free_tier": "Limited credits, testing only",
    "paid_start": "Standard tier required for production",
    "model": "Freemium with credit-based usage"
  },
  "issues": [
    "Website has redirect loops (robots.txt and llms.txt both fail with 'Exceeded maximum allowed redirects')",
    "Pricing details are vague — no clear credit costs or tier boundaries on main page",
    "No LLMs.txt or AI-friendly documentation endpoint found",
    "Auth requires API key management (not SSO/magic-link friendly)",
    "Onboarding likely requires manual registration and API key provisioning, not instant",
    "Venue data is valuable but API requires significant setup and usage limits are unclear"
  ],
  "recommendations": [
    "Add a concise 'Getting Started' guide with exact credit costs per endpoint",
    "Fix redirect loops on robots.txt and llms.txt endpoints",
    "Provide a playground or sandbox with immediate API keys for testing",
    "Add structured JSON examples for common queries in documentation",
    "Consider adding a free tier with generous credits for evaluation"
  ]
}
```