Instagram Data API for Node

An API built in Node .js is required to pull detailed Instagram profile and audience metrics so they can be consumed by an existing platform. The highest-priority data points are followers, following, engagement rate, audience country, e-mail addresses, and city/state, followed by age, gender, fake-versus-real follower ratio, profile picture and post metadata.

Engagement rate must follow the “likes + comments over a period of time” formula; please make the period configurable so I can test different windows later.

The service should expose clear JSON endpoints, return clean, well-typed responses, and include concise setup instructions for deployment on a standard Node environment. Before final hand-off I need a simple document that flags any fields Instagram does not make available so expectations are crystal-clear.

Deliverables
• Node .js codebase with REST (or lightweight GraphQL) endpoints
• Documentation: endpoint list, auth flow, environment variables, example calls
• Engagement-rate calculation module with configurable date range
• Field-availability report highlighting any unreachable metrics and proposed work-arounds
• Postman (or similar) collection for quick testing

Acceptance Criteria
• All priority data points above return correctly where Instagram permits
• Engagement figures match manual calculations on test accounts
• Setup from repo clone to first successful call takes <30 minutes on a fresh machine
• Code passes a brief review for clarity, modularity, and error handling

I am aiming to move quickly—please outline the shortest realistic turnaround you can commit to, along with any dependencies you foresee (e.g., Facebook App review, proxy requirements).