
Closed
Posted
Paid on delivery
# Instagram Integration API (Spring Boot) ## Overview This project implements the core integration with Instagram via the official Meta Graph API. The goal is to provide a stable foundation layer for all future product features by exposing **three reusable REST endpoints** that handle: 1. **User account linking (OAuth)** 2. **Data fetching (profile, media, followers)** 3. **Token refresh and account unlinking** --- ## Features / APIs ### Link Instagram Account **Purpose:** Allow a user to link their Instagram account using Meta OAuth and persist the user-scoped access token. **Endpoints** ``` GET /api/v1/instagram/link GET /api/v1/instagram/callback ``` **Responsibility** - Initiate Meta OAuth login - Callback handles authorization code and exchanges for access token - Store token info with metadata: - userId (internal app ID) - instagramUserId - scopes - expiry - accountType (Personal / Business / Creator) --- ### Instagram Data Fetch **Purpose:** Fetch Instagram user data via stored token and persist in the database. **Endpoint** ``` POST /api/v1/instagram/fetch ``` **Data retrieved & stored** - Profile details - Recent media - Followers list (conditionally based on account type and scopes) - Pagination handled --- ### Refresh / Unlink Instagram **Purpose:** Manage token refresh or revoke access. **Endpoints** ``` POST /api/v1/instagram/refresh DELETE /api/v1/instagram/unlink ``` **Responsibility** - Detect expired tokens - Try long-lived refresh (where applicable) - If expired or revoked, require re-auth - Revoke access at Meta and clear local data --- ## Technical Stack - Java - Spring Boot - Spring Security (OAuth utilities) - Spring Data JPA - Relational SQL Database (Postgres / MySQL / H2 for local) - Swagger / OpenAPI - Optional: RestFB or direct Graph API HTTP calls --- ## Environment Variables / Config Add the following to your environment (or `[login to view URL]`): ``` META_APP_ID=<your-meta-app-id> META_APP_SECRET=<your-meta-app-secret> META_REDIRECT_URI=<your-redirect-uri> DATABASE_URL=<your-database-url> DATABASE_USERNAME=<your-db-user> DATABASE_PASSWORD=<your-db-password> ``` --- ## Meta App Setup Instructions ### 1. Create Meta Developer Account 1. Visit [login to view URL] 2. Log in with a Facebook account 3. Accept developer terms --- ### 2. Create a New App 1. Click **My Apps → Create App** 2. Choose **Business** app type 3. Enter: - App Name (e.g., Instagram Integration API) - Contact Email 4. Click **Create App** --- ### 3. Configure Login & Permissions #### Add Facebook Login 1. On the app dashboard, go to **Use cases** 2. Find **Authenticate and request data from users with Facebook Login** 3. Click **Set Up** #### Add Instagram Graph API 1. Go to **Use cases** 2. Find **Instagram Graph API** 3. Click **Set Up** --- ### 4. Set OAuth Redirect URI 1. Go to **Facebook Login → Settings** 2. Under **Valid OAuth Redirect URIs**, add: ``` <META_REDIRECT_URI> ``` Example: ``` https://<ngrok-id>.[login to view URL] ``` Must match exactly --- ### 5. App Credentials Under **Settings → Basic**, note: ``` APP_ID APP_SECRET ``` Use these in environment variables. --- ### 6. Add Instagram Test Users 1. Go to **App Roles → Roles** 2. In **Instagram Testers**, add your IG username 3. On Instagram, accept the invite: - **Settings → Accounts Center → Apps and Websites** - Accept tester invite --- ## OAuth Scopes to Request These are required in the OAuth link: ``` instagram_basic pages_show_list instagram_manage_insights ``` --- ## Testing Use Swagger UI: ``` [http://localhost:8080/[login to view URL]](http://localhost:8080/[login to view URL]) ``` Ensure endpoints: - Link + callback work - Fetch works - Refresh/unlink work --- ## Acceptance Criteria 1. Project runs locally: ``` mvn spring-boot:run ``` 2. OAuth works end-to-end 3. Tokens stored securely per user 4. Account type persisted 5. Conditional fetch based on account type 6. Clear refresh logic 7. Unlink revokes access and cleans data 8. Swagger documented APIs 9. Postman/cURL scripts for: - Link start - OAuth callback - Fetch - Refresh - Unlink --- we allready have code jsut help me create Meta app and cofigure and run that code
Project ID: 40158751
11 proposals
Remote project
Active 9 days ago
Set your budget and timeframe
Get paid for your work
Outline your proposal
It's free to sign up and bid on jobs
11 freelancers are bidding on average ₹2,305 INR for this job

I have 21 years of experince and IIT graduate, Principal Software Engineer, I have extensive enterprise level experince in Java and Sprinboot, we can develop oauth using spirng security 3 o auth feature, fetch data and also do concurrent processing. Extensive experince with MVC and Spring boot, Spring data Jpa, that is the core of this project because the apis needs to be mapped properly with database schema and we need to write efficient JPQL queries for it. We can do app creation and configure the login part as per your requirement. Redirect to login and use env variable for it. We can test after the integration has been done. I have understood your requirements and can deliver fully.
₹15,000 INR in 7 days
6.0
6.0

Hi With 8 years of experience in integrating microservices APIs, I fully understand what you need. Let's discuss in detail Best
₹1,050 INR in 7 days
4.4
4.4

Greetings! I am thrilled about the opportunity to work on your Instagram Integration API project using Spring Boot. My proposal aims to deliver a robust solution that includes three key REST endpoints for seamless user account linking, data fetching (profile, media, followers), and token management functionalities. By implementing Meta Graph API integration, we can ensure a secure and reliable foundation for all upcoming product features. Let's collaborate to create a scalable and efficient system that meets your specific requirements. Regards, anilptk
₹1,100 INR in 3 days
3.9
3.9

Hi there, I’m Robert, a Senior Full-Stack & AI Engineer with over 10 years of experience architecting and delivering SaaS platforms, automation systems, and intelligent applications, specializing in Spring Boot, OAuth, and API development. I previously integrated a robust API system for a social media platform that facilitated user account linking and data fetching using OAuth protocols. My extensive experience ensures I can implement the Meta app setup and configure your existing code efficiently, leading to a seamless integration with the Instagram API. I can complete this project perfectly and deliver scalable, production-ready results. I am committed to clean architecture, structured documentation, CI/CD automation, and OWASP-based security practices. Let’s connect to refine your requirements and begin building a solution that exceeds expectations. What specific challenges are you facing with the Meta app setup?
₹600 INR in 5 days
3.2
3.2

As an experienced IT professional with a particular emphasis on website and systems management, I believe I bring a unique set of skills to the table for this project. My proficiency in Java and Spring, both of which are crucial aspects of this project, is well-documented and has been honed over years of hands-on experience. In addition to Java, I'm also fluent in PHP and its integration capacity in website design can be well-utilized here. This project heavily gears towards building a robust API that communicates seamlessly with Instagram's Meta Graph API, a task that necessitates both technical ability and regulatory conformance. Having developed various similar systems in the past, I am well-aware and confident in my expertise to ensure token security, long-lived refresh handling where applicable and managing revocation access as required. I work concisely with an eye for detail. Moreover, my adaptability makes me open to working with different databases, such as Postgres, MySQL and H2 for local environment, ensuring compatibility in all aspects. Let's leverage my experience and efficiency to create an Instagram Integration API that is a strong foundation for your product features.
₹1,150 INR in 14 days
0.0
0.0

Attention [Client], With over 5 years of experience specializing in Java, Spring Boot, and API integrations, I am the ideal freelancer to assist you in creating and configuring your Meta app for Instagram integration. By leveraging my expertise, I will seamlessly set up your Meta app, configure all necessary permissions and OAuth scopes, and ensure a smooth launch of your Instagram Integration API. To propel your project to success, I will meticulously handle the Meta app setup, streamline login and permissions configuration, and provide comprehensive guidance for a seamless transition to production. My track record includes successful API integrations and client satisfaction, evident in glowing testimonials available upon request. Let's kickstart your project — schedule a call today to delve into the specifics of your Meta app setup and integration needs. Looking forward to collaborating with you for a seamless and efficient solution. Best regards, Dylan Ashley Carlisle
₹1,150 INR in 14 days
0.0
0.0

Hi, I have reviewed your technical requirements and I can deliver this Spring Boot module exactly as specified. I see you need a robust implementation of the Instagram Graph API with three specific controller scopes: Auth, Fetch, and Refresh. My Implementation Plan: OAuth Flow: I will implement the /callback endpoint to exchange the authorization_code for a short-lived token, and immediately swap it for a Long-Lived Access Token (60 days) to ensure the user connection remains stable. Database Design: I will use Spring Data JPA to persist the instagramUserId, accessToken, and expiry time as requested in your schema requirements. Data Fetching: I will use RestTemplate or WebClient to hit the Graph API endpoints for profile and media data. Token Management: I will implement the refresh logic to check token expiry before making calls, ensuring the system never fails on a "401 Unauthorized." Tech Stack I will use: Java + Spring Boot (Latest Stable) Spring Security (for secure endpoint handling) Swagger/OpenAPI (I will auto-generate the docs for you to test easily) I have 1+ year of experience with Spring Boot and can start immediately. I will deliver the code within 3 days. Best regards, Yash Gupta
₹1,250 INR in 4 days
0.0
0.0

Hello, I have strong experience with Spring Boot + OAuth + Meta Graph API and can help you quickly complete this integration since the core code already exists. I will handle: - Meta (Facebook) app creation & configuration - Facebook Login + Instagram Graph API setup - Correct OAuth scopes & redirect URI configuration - Test user setup and validation - Running and verifying your existing Spring Boot code - End-to-end OAuth, fetch, refresh, and unlink testing - Swagger & Postman validation I understand Meta’s Instagram permissions, token lifecycle (short/long-lived), and development-mode restrictions very well. Delivery: 5–7 days Bid: ₹1,400 Looking forward to working with you.
₹1,400 INR in 7 days
0.0
0.0

Hi! I can help you set up the Meta app, configure Instagram Graph API + OAuth redirect, and run your existing Spring Boot code end-to-end. What I will do: 1) Create/configure the Meta app (Business type) + enable Facebook Login + Instagram Graph API 2) Set the exact OAuth Redirect URI and required permissions/scopes 3) Add Instagram test users and confirm the tester invite is accepted 4) Help you fill the env vars (APP_ID/SECRET/REDIRECT_URI + DB config) and run the project locally 5) Verify each endpoint works: - /api/v1/instagram/link + /callback - /api/v1/instagram/fetch (profile/media, followers if allowed) - /api/v1/instagram/refresh and /unlink 6) Provide a short checklist + Postman/cURL examples so you can re-test anytime To start, please share: - Your Git repo link or zip - Which DB you want for local (H2 / MySQL / Postgres) - The redirect URI you will use (localhost or ngrok) I can start immediately and deliver quickly once I have the repo and Meta app access.
₹850 INR in 2 days
0.0
0.0

India
Payment method verified
Member since Oct 20, 2020
₹600-1500 INR
₹600-1500 INR
₹600-1500 INR
₹600-1500 INR
₹1500-12500 INR
€250-750 EUR
$499-500 USD
$3000-5000 SGD
$10-30 USD
$250-750 USD
$250-750 AUD
₹37500-75000 INR
₹600-1500 INR
$15-25 USD / hour
₹75000-150000 INR
£8-20 GBP / hour
₹60000-80000 INR
₹1000-5000 INR
₹12500-37500 INR
$30-250 USD
₹75000-150000 INR
£5000-10000 GBP
€30-250 EUR
$10-30 USD
$250-750 USD