Instagram Hashtag Feed API (0.1.0)

The Instagram Hashtag Feed API provides a simple way to retrieve social media posts filtered by hashtags. The API supports two modes:

• Mock Mode (default): Returns sample data perfect for testing and demonstrations without requiring any credentials
• Instagram Mode: Fetches real data from the Instagram Graph API (requires authentication)

The API uses simple limit-based pagination:

• Use the limit parameter to control the number of results (1-100)
• Results are always sorted newest-first by timestamp
• Maximum limit is 100 items per request
• For production applications, consider implementing cursor-based pagination

The API returns descriptive error messages with appropriate HTTP status codes:

All error responses include:

• error: A code or short message describing the error
• details: Additional information about what went wrong

Common Errors

Instagram Mode Not Configured

{
  "error": "failed_to_fetch_feed",
  "details": "INSTAGRAM_ACCESS_TOKEN and INSTAGRAM_BUSINESS_ACCOUNT_ID required"
}

Rate Limiting

The API implements built-in caching (default TTL: 120 seconds) to reduce load on the Instagram Graph API. Identical requests within the cache window will return cached results.

• Main Portfolio Site
• API Source Code
• Full Documentation