igmapper 1.0.0__tar.gz

igmapper-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Author
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

igmapper-1.0.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: igmapper
+Version: 1.0.0
+Summary: Unofficial Instagram API to request available data
+Author: lucasoal
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/igmapper
+Project-URL: Documentation, https://github.com/lucasoal/igmapper/blob/main/doc/DOCUMENTATION.md
+Project-URL: Repository, https://github.com/lucasoal/igmapper
+Keywords: igmapper,instagram,unofficial-api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: requests
+Requires-Dist: pydantic
+Dynamic: license-file
+
+<div align="center">
+	<picture>
+	<source media="(prefers-color-scheme: dark)" srcset="assets/igmapper.svg">
+	<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lucasoal/igmapper/refs/heads/main/assets/igmapper.svg">
+		<img src="https://raw.githubusercontent.com/lucasoal/igmapper/refs/heads/main/assets/igmapper.svg" width="100%">
+	</picture>
+	<br><br><br>
+	<hr>
+<h1>igmapper: An Instagram Unofficial API</h1>
+
+<img src="https://img.shields.io/badge/Author-lucasoal-blue?logo=github&logoColor=white"> <img src="https://img.shields.io/badge/License-MIT-750014.svg"> <!-- <img src="https://img.shields.io/badge/Status-Beta-DF1F72">  -->
+<br>
+<img src="https://img.shields.io/pypi/v/igmapper.svg?label=Version&color=white"> <img src="https://img.shields.io/pypi/pyversions/igmapper?logo=python&logoColor=white&label=Python"> <img src="https://img.shields.io/badge/Code Style-Black Formatter-111.svg"> 
+<br>
+<img src="https://static.pepy.tech/badge/igmapper">
+<!-- <img src="https://img.shields.io/pypi/dm/igmapper.svg?label=PyPI Downloads"> -->
+
+</div>
+
+## What is it?
+**igmapper** is a high-performance Python library designed for Instagram data extraction, 
+providing structured access to profiles, feeds, and comments. It offers a flexible
+architecture that allows data engineers to toggle between Requests and native CURL
+transport, ensuring resilience against environment constraints.
+
+<h2>Table of Contents</h2><br>
+
+- [What is it?](#what-is-it)
+- [Main Features](#main-features)
+- [Where to get it / Install](#where-to-get-it--install)
+- [Documentation](#documentation)
+- [License](#license)
+- [Dependencies](#dependencies)
+
+## Main Features
+Here are just a few of the things that pandas does well:
+
+- [`InstaClient`](doc/DOCUMENTATION.md#instaclient): Initializes the session and handles transport selection (Requests or CURL)
+  - [`get_profile_info()`](doc/DOCUMENTATION.md#get_profile_info): Scrapes profile metadata and returns a structured ProfileData object.
+  - [`get_feed()`](doc/DOCUMENTATION.md#get_feed): Retrieves user timeline posts with built-in pagination support.
+  - [`get_comments()`](doc/DOCUMENTATION.md#get_comments): Fetches media comments and automates cursor-based pagination.
+
+## Where to get it / Install
+The source code is currently hosted on GitHub at: https://github.com/lucasoal/igmapper
+
+
+> [!WARNING]
+> It's essential to use [**Python 3.10** 🡽](https://www.python.org/downloads/release/python-310/) version
+<!-- > It's essential to **upgrade pip** to the latest version to ensure compatibility with the library. -->
+<!-- > ```sh
+> # Requires the latest pip
+> pip install --upgrade pip
+> ``` -->
+
+- [PyPI 🡽](https://pypi.org/project/igmapper/)
+	```sh
+	# PyPI
+	pip install igmapper
+	```
+- GitHub
+	```sh
+	# or GitHub
+	pip install git+https://github.com/lucasoal/igmapper.git
+	```
+
+## Documentation
+- [Documentation 🡽](https://github.com/lucasoal/igmapper/blob/main/doc/DOCUMENTATION.md).
+
+## License
+- [MIT 🡽](https://github.com/lucasoal/igmapper/blob/main/LICENSE)
+
+## Dependencies
+- [Requests](https://pypi.org/project/requests/) | [pydantic](https://pypi.org/project/pydantic/)
+
+See the [full installation instructions](https://github.com/lucasoal/igmapper/blob/main/INSTALLATION.md) for minimum supported versions of required, recommended and optional dependencies.
+
+<hr>
+
+[⇧ Go to Top](#table-of-contents)

igmapper-1.0.0/README.md

@@ -0,0 +1,79 @@
+<div align="center">
+	<picture>
+	<source media="(prefers-color-scheme: dark)" srcset="assets/igmapper.svg">
+	<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lucasoal/igmapper/refs/heads/main/assets/igmapper.svg">
+		<img src="https://raw.githubusercontent.com/lucasoal/igmapper/refs/heads/main/assets/igmapper.svg" width="100%">
+	</picture>
+	<br><br><br>
+	<hr>
+<h1>igmapper: An Instagram Unofficial API</h1>
+
+<img src="https://img.shields.io/badge/Author-lucasoal-blue?logo=github&logoColor=white"> <img src="https://img.shields.io/badge/License-MIT-750014.svg"> <!-- <img src="https://img.shields.io/badge/Status-Beta-DF1F72">  -->
+<br>
+<img src="https://img.shields.io/pypi/v/igmapper.svg?label=Version&color=white"> <img src="https://img.shields.io/pypi/pyversions/igmapper?logo=python&logoColor=white&label=Python"> <img src="https://img.shields.io/badge/Code Style-Black Formatter-111.svg"> 
+<br>
+<img src="https://static.pepy.tech/badge/igmapper">
+<!-- <img src="https://img.shields.io/pypi/dm/igmapper.svg?label=PyPI Downloads"> -->
+
+</div>
+
+## What is it?
+**igmapper** is a high-performance Python library designed for Instagram data extraction, 
+providing structured access to profiles, feeds, and comments. It offers a flexible
+architecture that allows data engineers to toggle between Requests and native CURL
+transport, ensuring resilience against environment constraints.
+
+<h2>Table of Contents</h2><br>
+
+- [What is it?](#what-is-it)
+- [Main Features](#main-features)
+- [Where to get it / Install](#where-to-get-it--install)
+- [Documentation](#documentation)
+- [License](#license)
+- [Dependencies](#dependencies)
+
+## Main Features
+Here are just a few of the things that pandas does well:
+
+- [`InstaClient`](doc/DOCUMENTATION.md#instaclient): Initializes the session and handles transport selection (Requests or CURL)
+  - [`get_profile_info()`](doc/DOCUMENTATION.md#get_profile_info): Scrapes profile metadata and returns a structured ProfileData object.
+  - [`get_feed()`](doc/DOCUMENTATION.md#get_feed): Retrieves user timeline posts with built-in pagination support.
+  - [`get_comments()`](doc/DOCUMENTATION.md#get_comments): Fetches media comments and automates cursor-based pagination.
+
+## Where to get it / Install
+The source code is currently hosted on GitHub at: https://github.com/lucasoal/igmapper
+
+
+> [!WARNING]
+> It's essential to use [**Python 3.10** 🡽](https://www.python.org/downloads/release/python-310/) version
+<!-- > It's essential to **upgrade pip** to the latest version to ensure compatibility with the library. -->
+<!-- > ```sh
+> # Requires the latest pip
+> pip install --upgrade pip
+> ``` -->
+
+- [PyPI 🡽](https://pypi.org/project/igmapper/)
+	```sh
+	# PyPI
+	pip install igmapper
+	```
+- GitHub
+	```sh
+	# or GitHub
+	pip install git+https://github.com/lucasoal/igmapper.git
+	```
+
+## Documentation
+- [Documentation 🡽](https://github.com/lucasoal/igmapper/blob/main/doc/DOCUMENTATION.md).
+
+## License
+- [MIT 🡽](https://github.com/lucasoal/igmapper/blob/main/LICENSE)
+
+## Dependencies
+- [Requests](https://pypi.org/project/requests/) | [pydantic](https://pypi.org/project/pydantic/)
+
+See the [full installation instructions](https://github.com/lucasoal/igmapper/blob/main/INSTALLATION.md) for minimum supported versions of required, recommended and optional dependencies.
+
+<hr>
+
+[⇧ Go to Top](#table-of-contents)

igmapper-1.0.0/igmapper/__init__.py

@@ -0,0 +1,3 @@
+from .client import InstaClient
+
+__all__ = ["InstaClient"]

igmapper-1.0.0/igmapper/client.py

@@ -0,0 +1,126 @@
+import json
+import subprocess
+import urllib.parse
+
+from .models import FeedData, ProfileData, CommentsData
+from .session import InstagramSession
+
+
+class InstaClient:
+    def __init__(self, csrftoken, ds_user_id, sessionid, proxy=None, use_curl=False):
+        """
+        :param use_curl: Se True, utiliza chamadas via subprocess CURL em vez de requests.
+        """
+        self.state = InstagramSession(csrftoken, ds_user_id, sessionid, proxy=proxy)
+        self.use_curl = use_curl
+
+    def _execute_request(self, method, url, params=None):
+        """Gerencia se a requisição será via Requests ou CURL."""
+        if params:
+            url = f"{url}?{urllib.parse.urlencode(params)}"
+
+        if not self.use_curl:
+            return self.state.request_on_session(method, url)
+
+        return self._curl_request(method, url)
+
+    def _curl_request(self, method, url):
+        """Simula o comportamento do requests utilizando o binário curl do sistema."""
+        cookie_str = (
+            f"csrftoken={self.state.session.cookies.get('csrftoken')}; "
+            f"ds_user_id={self.state.session.cookies.get('ds_user_id')}; "
+            f"sessionid={self.state.session.cookies.get('sessionid')};"
+        )
+
+        command = [
+            "curl",
+            "-X",
+            method,
+            url,
+            "-H",
+            f"cookie: {cookie_str}",
+            "-H",
+            f"x-ig-app-id: {self.state.xigappid}",
+            "-sS",
+        ]
+
+        if self.state.session.proxies.get("https"):
+            command.extend(["-x", self.state.session.proxies["https"]])
+
+        result = subprocess.run(command, capture_output=True, text=True)
+
+        class MockResponse:
+            def __init__(self, text, status_code):
+                self.text = text
+                self.status_code = status_code
+
+            def json(self):
+                return json.loads(self.text)
+
+        status = 200 if result.returncode == 0 else 500
+        return MockResponse(result.stdout, status)
+
+    def get_profile_info(self, username: str, return_raw: bool = False):
+        url = f"https://www.instagram.com/api/v1/users/web_profile_info/"
+        params = {"username": username}
+        response = self._execute_request("GET", url, params=params)
+
+        if response.status_code != 200:
+            return None
+
+        data = response.json()
+        if return_raw:
+            return data
+
+        return ProfileData.parse_instagram_json(data)
+
+    def get_feed(self, username: str, max_id: str = "", return_raw: bool = False):
+        url = f"https://www.instagram.com/api/v1/feed/user/{username}/username/"
+        params = {"count": 33, "max_id": max_id}
+
+        response = self._execute_request("GET", url, params=params)
+
+        if response.status_code != 200:
+            return None
+
+        data = response.json()
+
+        if return_raw:
+            return data
+
+        items = data.get("items", [])
+        posts = [FeedData.parse_item(item) for item in items]
+
+        return FeedData(
+            posts=posts,
+            next_max_id=data.get("next_max_id"),
+            num_results=data.get("num_results", 0),
+            more_available=data.get("more_available", False),
+        )
+
+    def get_comments(self, media_id: str, next_min_id: str = None, return_raw: bool = False):
+        url = f"https://www.instagram.com/api/v1/media/{media_id}/comments/"
+
+        params = {"can_support_threading": "true"}
+        if next_min_id:
+            params["min_id"] = next_min_id
+
+        response = self._execute_request("GET", url, params=params)
+
+        if response.status_code != 200:
+            return None
+
+        data = response.json()
+
+        if return_raw:
+            return data
+
+        comments_data = data.get("comments", [])
+        comments = [CommentsData.parse_item(item) for item in comments_data]
+
+        return CommentsData(
+            comments=comments,
+            next_max_id=data.get("next_min_id"),
+            num_results=len(comments),
+            more_available=data.get("has_more_comments", False),
+        )

igmapper-1.0.0/igmapper/models.py

@@ -0,0 +1,211 @@
+import json
+from datetime import datetime
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field, HttpUrl
+
+
+class ProfileData(BaseModel):
+    """Modelo estruturado para informações completas do perfil."""
+
+    # Básico
+    id: str
+    username: str
+    full_name: Optional[str]
+    biography: Optional[str]
+    profile_pic_url: Optional[HttpUrl]
+
+    # Status
+    is_private: bool
+    is_verified: bool
+    is_business_account: bool
+    is_professional_account: bool
+
+    # Métricas
+    follower_count: int
+    following_count: int
+    total_posts: int
+    highlight_reel_count: int
+    mutual_followers: int
+
+    # Categoria
+    category_name: Optional[str]
+    business_category_name: Optional[str]
+    should_show_category: Optional[bool]
+
+    # Conteúdo
+    has_clips: Optional[bool]
+    has_guides: Optional[bool]
+    has_channel: Optional[bool]
+
+    # Links
+    external_url: Optional[HttpUrl]
+    bio_links: List[Dict[str, Any]] = []
+
+    # Localização (raw dict já parseado)
+    business_address: Optional[Dict[str, Any]]
+
+    # Contatos
+    should_show_public_contacts: Optional[bool]
+    business_email: Optional[str]
+    business_phone_number: Optional[str]
+
+    @classmethod
+    def parse_instagram_json(cls, data: dict):
+        """Helper para limpar o aninhamento profundo do JSON original."""
+        user = data.get("data", {}).get("user", {})
+        if not user:
+            return None
+
+        # Parse do endereço comercial (string JSON → dict)
+        business_address_raw = user.get("business_address_json")
+        parsed_address = None
+        if business_address_raw:
+            try:
+                parsed_address = json.loads(business_address_raw)
+            except Exception:
+                parsed_address = None
+
+        return cls(
+            # Básico
+            id=user.get("id"),
+            username=user.get("username"),
+            full_name=user.get("full_name"),
+            biography=user.get("biography"),
+            profile_pic_url=user.get("profile_pic_url_hd"),
+            # Status
+            is_private=user.get("is_private", False),
+            is_verified=user.get("is_verified", False),
+            is_business_account=user.get("is_business_account", False),
+            is_professional_account=user.get("is_professional_account", False),
+            # Métricas
+            follower_count=user.get("edge_followed_by", {}).get("count", 0),
+            following_count=user.get("edge_follow", {}).get("count", 0),
+            total_posts=user.get("edge_owner_to_timeline_media", {}).get("count", 0),
+            highlight_reel_count=user.get("highlight_reel_count", 0),
+            mutual_followers=user.get("edge_mutual_followed_by", {}).get("count", 0),
+            # Categoria
+            category_name=user.get("category_name"),
+            business_category_name=user.get("business_category_name"),
+            should_show_category=user.get("should_show_category"),
+            # Conteúdo
+            has_clips=user.get("has_clips"),
+            has_guides=user.get("has_guides"),
+            has_channel=user.get("has_channel"),
+            # Links
+            external_url=user.get("external_url"),
+            bio_links=user.get("bio_links", []),
+            # Localização
+            business_address=parsed_address,
+            # Contatos
+            should_show_public_contacts=user.get("should_show_public_contacts"),
+            business_email=user.get("business_email"),
+            business_phone_number=user.get("business_phone_number"),
+        )
+
+
+class FeedData(BaseModel):
+    # Dados do Post
+    post_id: Optional[str] = Field(default=None, alias="id")
+    pk: Optional[str] = None
+    shortcode: Optional[str] = Field(default=None, alias="code")
+    created_at: Optional[datetime] = None
+    caption: Optional[str] = None
+    media_url: Optional[HttpUrl] = None
+    media_type: Optional[int] = None
+    like_count: Optional[int] = 0
+    comment_count: Optional[int] = 0
+    view_count: Optional[int] = None
+    carousel_media_count: Optional[int] = 0
+
+    # Dados do Feed
+    posts: Optional[List["FeedData"]] = None
+    next_max_id: Optional[str] = None
+    num_results: Optional[int] = None
+    more_available: Optional[bool] = None
+
+    @classmethod
+    def parse_item(cls, item: dict):
+        ts = item.get("taken_at") or (item.get("device_timestamp", 0) / 1_000_000)
+
+        caption_dict = item.get("caption")
+        caption_text = caption_dict.get("text") if caption_dict else None
+
+        candidates = item.get("image_versions2", {}).get("candidates", [])
+        best_image = candidates[0].get("url") if candidates else None
+
+        return cls(
+            id=item.get("id"),
+            pk=item.get("pk"),
+            code=item.get("code"),
+            created_at=datetime.fromtimestamp(ts) if ts else None,
+            caption=caption_text,
+            media_url=best_image,
+            media_type=item.get("media_type"),
+            like_count=item.get("like_count", 0),
+            comment_count=item.get("comment_count", 0),
+            view_count=item.get("view_count"),
+            carousel_media_count=item.get("carousel_media_count", 0),
+        )
+
+
+class CommentsData(BaseModel):
+    # Dados do Comentário
+    comment_id: Optional[str] = Field(default=None, alias="pk")
+    media_id: Optional[str] = None
+    text: Optional[str] = None
+    created_at: Optional[datetime] = None
+    like_count: Optional[int] = Field(default=0, alias="comment_like_count")
+    content_type: Optional[str] = None
+    status: Optional[str] = None
+    is_ranked_comment: Optional[bool] = None
+    is_edited: Optional[bool] = None
+
+    # Dados do Autor
+    user_id: Optional[str] = None
+    username: Optional[str] = None
+    full_name: Optional[str] = None
+    profile_pic_url: Optional[HttpUrl] = None
+    is_private: Optional[bool] = None
+    is_verified: Optional[bool] = None
+
+    # Dados da Listagem
+    comments: Optional[List["CommentsData"]] = None
+    next_max_id: Optional[str] = None
+    num_results: Optional[int] = None
+    more_available: Optional[bool] = None
+
+    @classmethod
+    def parse_item(cls, item: dict):
+        ts = item.get("created_at")
+
+        user = item.get("user", {})
+
+        return cls(
+            pk=item.get("pk"),
+            media_id=item.get("media_id"),
+            text=item.get("text"),
+            created_at=datetime.fromtimestamp(ts) if ts else None,
+            comment_like_count=item.get("comment_like_count", 0),
+            content_type=item.get("content_type"),
+            status=item.get("status"),
+            is_ranked_comment=item.get("is_ranked_comment"),
+            is_edited=item.get("is_edited"),
+            user_id=user.get("id"),
+            username=user.get("username"),
+            full_name=user.get("full_name"),
+            profile_pic_url=user.get("profile_pic_url"),
+            is_private=user.get("is_private"),
+            is_verified=user.get("is_verified"),
+        )
+
+    @classmethod
+    def parse_response(cls, data: dict):
+        comments_data = data.get("comments", [])
+
+        return cls(
+            comments=[cls.parse_item(item) for item in comments_data],
+            next_max_id=data.get("next_max_id"),
+            num_results=data.get("num_results"),
+            more_available=data.get("more_available"),
+        )

igmapper-1.0.0/igmapper/session.py

@@ -0,0 +1,32 @@
+import requests
+
+
+class InstagramSession:
+    def __init__(self, csrftoken, ds_user_id, sessionid, xigappid="936619743392459", proxy=None):
+        self.session = requests.Session()
+        self.xigappid = xigappid
+        self.proxy = proxy
+
+        self.session.cookies.set("csrftoken", csrftoken)
+        self.session.cookies.set("ds_user_id", ds_user_id)
+        self.session.cookies.set("sessionid", sessionid)
+
+        self.default_headers = {
+            "x-ig-app-id": self.xigappid,
+            "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36",
+            "accept": "*/*",
+            "accept-language": "en-US,en;q=0.9",
+        }
+        self.session.headers.update(self.default_headers)
+
+        if proxy:
+            self.session.proxies = {"http": proxy, "https": proxy}
+
+    def get_cookie_string(self):
+        """Retorna os cookies formatados para o cabeçalho do CURL."""
+        c = self.session.cookies.get_dict()
+        return "; ".join([f"{k}={v}" for k, v in c.items()])
+
+    def request_on_session(self, method, url, **kwargs):
+        """Método para requisições via Requests (Python)."""
+        return self.session.request(method, url, timeout=10, **kwargs)

igmapper-1.0.0/igmapper.egg-info/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: igmapper
+Version: 1.0.0
+Summary: Unofficial Instagram API to request available data
+Author: lucasoal
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/igmapper
+Project-URL: Documentation, https://github.com/lucasoal/igmapper/blob/main/doc/DOCUMENTATION.md
+Project-URL: Repository, https://github.com/lucasoal/igmapper
+Keywords: igmapper,instagram,unofficial-api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: requests
+Requires-Dist: pydantic
+Dynamic: license-file
+
+<div align="center">
+	<picture>
+	<source media="(prefers-color-scheme: dark)" srcset="assets/igmapper.svg">
+	<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lucasoal/igmapper/refs/heads/main/assets/igmapper.svg">
+		<img src="https://raw.githubusercontent.com/lucasoal/igmapper/refs/heads/main/assets/igmapper.svg" width="100%">
+	</picture>
+	<br><br><br>
+	<hr>
+<h1>igmapper: An Instagram Unofficial API</h1>
+
+<img src="https://img.shields.io/badge/Author-lucasoal-blue?logo=github&logoColor=white"> <img src="https://img.shields.io/badge/License-MIT-750014.svg"> <!-- <img src="https://img.shields.io/badge/Status-Beta-DF1F72">  -->
+<br>
+<img src="https://img.shields.io/pypi/v/igmapper.svg?label=Version&color=white"> <img src="https://img.shields.io/pypi/pyversions/igmapper?logo=python&logoColor=white&label=Python"> <img src="https://img.shields.io/badge/Code Style-Black Formatter-111.svg"> 
+<br>
+<img src="https://static.pepy.tech/badge/igmapper">
+<!-- <img src="https://img.shields.io/pypi/dm/igmapper.svg?label=PyPI Downloads"> -->
+
+</div>
+
+## What is it?
+**igmapper** is a high-performance Python library designed for Instagram data extraction, 
+providing structured access to profiles, feeds, and comments. It offers a flexible
+architecture that allows data engineers to toggle between Requests and native CURL
+transport, ensuring resilience against environment constraints.
+
+<h2>Table of Contents</h2><br>
+
+- [What is it?](#what-is-it)
+- [Main Features](#main-features)
+- [Where to get it / Install](#where-to-get-it--install)
+- [Documentation](#documentation)
+- [License](#license)
+- [Dependencies](#dependencies)
+
+## Main Features
+Here are just a few of the things that pandas does well:
+
+- [`InstaClient`](doc/DOCUMENTATION.md#instaclient): Initializes the session and handles transport selection (Requests or CURL)
+  - [`get_profile_info()`](doc/DOCUMENTATION.md#get_profile_info): Scrapes profile metadata and returns a structured ProfileData object.
+  - [`get_feed()`](doc/DOCUMENTATION.md#get_feed): Retrieves user timeline posts with built-in pagination support.
+  - [`get_comments()`](doc/DOCUMENTATION.md#get_comments): Fetches media comments and automates cursor-based pagination.
+
+## Where to get it / Install
+The source code is currently hosted on GitHub at: https://github.com/lucasoal/igmapper
+
+
+> [!WARNING]
+> It's essential to use [**Python 3.10** 🡽](https://www.python.org/downloads/release/python-310/) version
+<!-- > It's essential to **upgrade pip** to the latest version to ensure compatibility with the library. -->
+<!-- > ```sh
+> # Requires the latest pip
+> pip install --upgrade pip
+> ``` -->
+
+- [PyPI 🡽](https://pypi.org/project/igmapper/)
+	```sh
+	# PyPI
+	pip install igmapper
+	```
+- GitHub
+	```sh
+	# or GitHub
+	pip install git+https://github.com/lucasoal/igmapper.git
+	```
+
+## Documentation
+- [Documentation 🡽](https://github.com/lucasoal/igmapper/blob/main/doc/DOCUMENTATION.md).
+
+## License
+- [MIT 🡽](https://github.com/lucasoal/igmapper/blob/main/LICENSE)
+
+## Dependencies
+- [Requests](https://pypi.org/project/requests/) | [pydantic](https://pypi.org/project/pydantic/)
+
+See the [full installation instructions](https://github.com/lucasoal/igmapper/blob/main/INSTALLATION.md) for minimum supported versions of required, recommended and optional dependencies.
+
+<hr>
+
+[⇧ Go to Top](#table-of-contents)

igmapper-1.0.0/igmapper.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+AUTHORS.md
+LICENSE
+README.md
+pyproject.toml
+igmapper/__init__.py
+igmapper/client.py
+igmapper/models.py
+igmapper/session.py
+igmapper.egg-info/PKG-INFO
+igmapper.egg-info/SOURCES.txt
+igmapper.egg-info/dependency_links.txt
+igmapper.egg-info/requires.txt
+igmapper.egg-info/top_level.txt
+tests/test_feed.py
+tests/test_profile.py

igmapper-1.0.0/igmapper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

igmapper-1.0.0/igmapper.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests
+pydantic

igmapper-1.0.0/igmapper.egg-info/top_level.txt

@@ -0,0 +1 @@
+igmapper

igmapper-1.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "igmapper"
+version = "1.0.0"
+description = "Unofficial Instagram API to request available data"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+
+authors = [
+  { name = "lucasoal" }
+]
+
+keywords = [
+   "igmapper", "instagram", "unofficial-api",
+]
+
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3.10",
+  "Topic :: Software Development :: Libraries"
+]
+
+dependencies = [
+  "requests", "pydantic",
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/igmapper"
+Documentation = "https://github.com/lucasoal/igmapper/blob/main/doc/DOCUMENTATION.md"
+Repository = 'https://github.com/lucasoal/igmapper'
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["igmapper*"]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = "-ra"
+testpaths = ["tests"]

igmapper-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

igmapper-1.0.0/tests/test_feed.py

@@ -0,0 +1,39 @@
+import pytest
+from _vars import *
+
+from igmapper.client import InstaClient
+
+
+# @pytest.mark.skipif(not IG_SESSIONID, reason="Sem login")
+def test_get_feed_real():
+    client = InstaClient(IG_CSRFTOKEN, IG_DS_USER_ID, IG_SESSIONID)
+
+    feed = client.get_feed(IG_USERNAME)
+
+    assert feed is not None
+    assert len(feed.posts) > 0
+    assert feed.num_results > 0
+
+    # Verifica se o primeiro post tem dados consistentes
+    post = feed.posts[0]
+    assert post.post_id is not None
+    assert post.shortcode is not None
+    print(f"\nFeed capturado. Último post: {post.shortcode}")
+
+
+@pytest.mark.skipif(not IG_CSRFTOKEN, reason="Credenciais não configuradas")
+def test_get_feed_real_curl():
+    # Testa via CURL
+    client = InstaClient(IG_CSRFTOKEN, IG_DS_USER_ID, IG_SESSIONID, use_curl=True)
+
+    feed = client.get_feed(IG_USERNAME)
+
+    assert feed is not None
+    assert len(feed.posts) > 0
+    assert feed.num_results > 0
+
+    # Verifica se o primeiro post tem dados consistentes
+    post = feed.posts[0]
+    assert post.post_id is not None
+    assert post.shortcode is not None
+    print(f"\nFeed capturado. Último post: {post.shortcode}")

igmapper-1.0.0/tests/test_profile.py

@@ -0,0 +1,29 @@
+import os
+
+import pytest
+from _vars import *
+
+from igmapper.client import InstaClient
+
+
+@pytest.mark.skipif(not IG_SESSIONID, reason="Credenciais não configuradas")
+def test_get_profile_info_real():
+    # Testa via REQUESTS
+    client = InstaClient(IG_CSRFTOKEN, IG_DS_USER_ID, IG_SESSIONID, use_curl=False)
+    profile = client.get_profile_info(IG_USERNAME)
+
+    assert profile is not None
+    assert profile.username == IG_USERNAME
+    assert profile.follower_count > 0
+    print(f"\n[Requests] Sucesso: {profile.full_name} tem {profile.follower_count} seguidores.")
+
+
+@pytest.mark.skipif(not IG_CSRFTOKEN, reason="Credenciais não configuradas")
+def test_get_profile_info_real_curl():
+    # Testa via CURL
+    client = InstaClient(IG_CSRFTOKEN, IG_DS_USER_ID, IG_SESSIONID, use_curl=True)
+    profile = client.get_profile_info(IG_USERNAME)
+
+    assert profile is not None
+    assert profile.username == IG_USERNAME
+    print(f"\n[CURL] Sucesso: {profile.full_name} capturado via binário do sistema.")