sharpapi-python-client 1.0.0__tar.gz

sharpapi_python_client-1.0.0/LICENSE

@@ -0,0 +1,11 @@
+uMIT License
+
+Copyright (c) 2024 SharpAPI
+
+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.
+

sharpapi_python_client-1.0.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.1
+Name: sharpapi-python-client
+Version: 1.0.0
+Summary: SharpAPI.com Python SDK Client - AI-Powered Workflow Automation API.
+Home-page: https://sharpapi.com
+License: MIT
+Author: Dawid Makowski
+Author-email: contact@sharpapi.com
+Requires-Python: >=3.8,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: requests (>=2.25.1)
+Project-URL: Documentation, https://sharpapi.com/documentation
+Project-URL: Repository, https://github.com/sharpapi/sharpapi-python-client
+Description-Content-Type: text/markdown
+
+# SharpAPI Python Client SDK
+
+🚀 Automate workflows with AI-powered API
+
+## Leverage AI API to streamline workflows in E-Commerce, Marketing, Content Management, HR Tech, Travel, and more.
+
+[![Version](https://img.shields.io/pypi/v/sharpapi-python-client.svg)](https://pypi.org/project/sharpapi-python-client/)
+[![License](https://img.shields.io/pypi/l/sharpapi-python-client.svg)](https://github.com/yourusername/sharpapi-python-client/blob/main/LICENSE)
+
+#### Save time on repetitive content analysis and generation tasks that your app users perform daily.
+
+See more at [SharpAPI.com Website »](https://sharpapi.com/)
+
+## Requirements
+
+- Python >= 3.6
+
+
+## Installation
+
+```bash
+pip install sharpapi-python-client
+
+
+## What can it do for you?
+
+- **E-commerce**
+  - Generate engaging product introductions.
+  - Create personalized thank-you emails.
+  - Streamline product categorization.
+  - Perform sentiment analysis on product reviews.
+
+- **Content & Marketing Automation**
+  - Translate text for a global audience.
+  - Paraphrase and proofread any text.
+  - Detect spam content.
+  - Extract contact information.
+  - Summarize content and generate keywords/tags.
+  - Generate SEO meta tags.
+
+- **HR Tech**
+  - Generate job descriptions.
+  - Identify related job positions and skills.
+  - Parse and extract information from resumes.
+
+- **Travel, Tourism & Hospitality**
+  - Analyze sentiment in travel reviews.
+  - Categorize tours, activities, and hospitality products.
+
+## Usage
+
+### Simple Example
+
+```python
+from sharpapi.sharp_api_service import SharpApiService
+
+sharp_api = SharpApiService('YOUR_SHARP_API_KEY')
+
+try:
+    status_url = sharp_api.product_categories(
+        'Lenovo Chromebook Laptop (2023), 14" FHD Touchscreen Slim 3, 8-Core MediaTek Kompanio 520 CPU, 4GB RAM, 128GB Storage',
+        language='German',  # optional
+        max_quantity=400,  # optional
+        voice_tone='Neutral',  # optional
+        context='Optional current e-store categories'  # optional
+    )
+
+    result_sharp_api_job = sharp_api.fetch_results(status_url)
+    print(result_sharp_api_job.get_result_json())
+except Exception as e:
+    print(e)
+```
+
+## Documentation
+For detailed usage and API methods, please refer to the [SharpAPI Documentation](https://sharpapi.com/documentation).
+
+## Changelog
+Please see CHANGELOG for more information on what has changed recently.
+
+## License
+The MIT License (MIT). Please see License File for more information.
+

sharpapi_python_client-1.0.0/README.md

@@ -0,0 +1,81 @@
+# SharpAPI Python Client SDK
+
+🚀 Automate workflows with AI-powered API
+
+## Leverage AI API to streamline workflows in E-Commerce, Marketing, Content Management, HR Tech, Travel, and more.
+
+[![Version](https://img.shields.io/pypi/v/sharpapi-python-client.svg)](https://pypi.org/project/sharpapi-python-client/)
+[![License](https://img.shields.io/pypi/l/sharpapi-python-client.svg)](https://github.com/yourusername/sharpapi-python-client/blob/main/LICENSE)
+
+#### Save time on repetitive content analysis and generation tasks that your app users perform daily.
+
+See more at [SharpAPI.com Website »](https://sharpapi.com/)
+
+## Requirements
+
+- Python >= 3.6
+
+
+## Installation
+
+```bash
+pip install sharpapi-python-client
+
+
+## What can it do for you?
+
+- **E-commerce**
+  - Generate engaging product introductions.
+  - Create personalized thank-you emails.
+  - Streamline product categorization.
+  - Perform sentiment analysis on product reviews.
+
+- **Content & Marketing Automation**
+  - Translate text for a global audience.
+  - Paraphrase and proofread any text.
+  - Detect spam content.
+  - Extract contact information.
+  - Summarize content and generate keywords/tags.
+  - Generate SEO meta tags.
+
+- **HR Tech**
+  - Generate job descriptions.
+  - Identify related job positions and skills.
+  - Parse and extract information from resumes.
+
+- **Travel, Tourism & Hospitality**
+  - Analyze sentiment in travel reviews.
+  - Categorize tours, activities, and hospitality products.
+
+## Usage
+
+### Simple Example
+
+```python
+from sharpapi.sharp_api_service import SharpApiService
+
+sharp_api = SharpApiService('YOUR_SHARP_API_KEY')
+
+try:
+    status_url = sharp_api.product_categories(
+        'Lenovo Chromebook Laptop (2023), 14" FHD Touchscreen Slim 3, 8-Core MediaTek Kompanio 520 CPU, 4GB RAM, 128GB Storage',
+        language='German',  # optional
+        max_quantity=400,  # optional
+        voice_tone='Neutral',  # optional
+        context='Optional current e-store categories'  # optional
+    )
+
+    result_sharp_api_job = sharp_api.fetch_results(status_url)
+    print(result_sharp_api_job.get_result_json())
+except Exception as e:
+    print(e)
+```
+
+## Documentation
+For detailed usage and API methods, please refer to the [SharpAPI Documentation](https://sharpapi.com/documentation).
+
+## Changelog
+Please see CHANGELOG for more information on what has changed recently.
+
+## License
+The MIT License (MIT). Please see License File for more information.

sharpapi_python_client-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[tool.poetry]
+name = "sharpapi-python-client"
+version = "1.0.0"
+description = "SharpAPI.com Python SDK Client - AI-Powered Workflow Automation API."
+authors = ["Dawid Makowski <contact@sharpapi.com>"]
+license = "MIT"
+readme = "README.md"
+homepage = "https://sharpapi.com"
+repository = "https://github.com/sharpapi/sharpapi-python-client"
+documentation = "https://sharpapi.com/documentation"
+
+packages = [
+    { include = "sharpapi", from = "src" }
+]
+
+[tool.poetry.dependencies]
+python = "^3.8"
+requests = ">=2.25.1"
+
+[tool.poetry.dev-dependencies]
+pytest = "^7.0"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

sharpapi_python_client-1.0.0/src/sharpapi/__init__.py

@@ -0,0 +1,13 @@
+# sharpapi/__init__.py
+
+"""
+SharpAPI Python SDK Package Initialization
+"""
+
+# Import the main service class for easy access
+from .sharp_api_service import SharpApiService
+
+# Import subpackages
+from . import dto
+from . import enums
+

sharpapi_python_client-1.0.0/src/sharpapi/dto/__init__.py

@@ -0,0 +1,10 @@
+# sharpapi/dto/__init__.py
+
+"""
+Data Transfer Objects (DTO) Package Initialization
+"""
+
+# Import DTO classes for easy access
+from .job_description_parameters import JobDescriptionParameters
+from .sharp_api_job import SharpApiJob
+from .sharp_api_subscription_info import SharpApiSubscriptionInfo

sharpapi_python_client-1.0.0/src/sharpapi/dto/job_description_parameters.py

@@ -0,0 +1,48 @@
+class JobDescriptionParameters:
+    def __init__(
+        self,
+        name,
+        company_name=None,
+        minimum_work_experience=None,
+        minimum_education=None,
+        employment_type=None,
+        required_skills=None,
+        optional_skills=None,
+        country=None,
+        remote=None,
+        visa_sponsored=None,
+        voice_tone=None,
+        context=None,
+        language=None,
+    ):
+        self.name = name
+        self.company_name = company_name
+        self.minimum_work_experience = minimum_work_experience
+        self.minimum_education = minimum_education
+        self.employment_type = employment_type
+        self.required_skills = required_skills
+        self.optional_skills = optional_skills
+        self.country = country
+        self.remote = remote
+        self.visa_sponsored = visa_sponsored
+        self.voice_tone = voice_tone
+        self.context = context
+        self.language = language
+
+    def to_dict(self):
+        return {
+            'name': self.name,
+            'company_name': self.company_name,
+            'minimum_work_experience': self.minimum_work_experience,
+            'minimum_education': self.minimum_education,
+            'employment_type': self.employment_type,
+            'required_skills': self.required_skills,
+            'optional_skills': self.optional_skills,
+            'country': self.country,
+            'remote': self.remote,
+            'visa_sponsored': self.visa_sponsored,
+            'voice_tone': self.voice_tone,
+            'context': self.context,
+            'language': self.language,
+        }
+

sharpapi_python_client-1.0.0/src/sharpapi/dto/sharp_api_job.py

@@ -0,0 +1,27 @@
+from ..enums.sharp_api_job_status_enum import SharpApiJobStatusEnum
+from ..enums.sharp_api_job_type_enum import SharpApiJobTypeEnum
+import json
+
+
+class SharpApiJob:
+    def __init__(self, id, type, status, result):
+        self.id = id
+        self.type = type
+        self.status = status
+        self.result = result
+
+    def get_id(self):
+        return self.id
+
+    def get_type(self):
+        return self.type
+
+    def get_status(self):
+        return self.status
+
+    def get_result_json(self):
+        return json.dumps(self.result, indent=2) if self.result else None
+
+    def get_result_object(self):
+        return self.result
+

sharpapi_python_client-1.0.0/src/sharpapi/dto/sharp_api_subscription_info.py

@@ -0,0 +1,15 @@
+from datetime import datetime
+
+
+class SharpApiSubscriptionInfo:
+    def __init__(self, data):
+        self.timestamp = datetime.fromisoformat(data['timestamp'])
+        self.on_trial = data['on_trial']
+        self.trial_ends = datetime.fromisoformat(data['trial_ends'])
+        self.subscribed = data['subscribed']
+        self.current_subscription_start = datetime.fromisoformat(data['current_subscription_start'])
+        self.current_subscription_end = datetime.fromisoformat(data['current_subscription_end'])
+        self.subscription_words_quota = data['subscription_words_quota']
+        self.subscription_words_used = data['subscription_words_used']
+        self.subscription_words_used_percentage = data['subscription_words_used_percentage']
+

sharpapi_python_client-1.0.0/src/sharpapi/enums/__init__.py

@@ -0,0 +1,10 @@
+# sharpapi/enums/__init__.py
+
+"""
+Enumerations Package Initialization
+"""
+from .sharp_api_job_status_enum import SharpApiJobStatusEnum
+from .sharp_api_job_type_enum import SharpApiJobTypeEnum
+from .sharp_api_languages import SharpApiLanguages
+from .sharp_api_voice_tone import SharpApiVoiceTone
+

sharpapi_python_client-1.0.0/src/sharpapi/enums/sharp_api_job_status_enum.py

@@ -0,0 +1,9 @@
+from enum import Enum
+
+
+class SharpApiJobStatusEnum(Enum):
+    NEW = 'new'
+    PENDING = 'pending'
+    FAILED = 'failed'
+    SUCCESS = 'success'
+

sharpapi_python_client-1.0.0/src/sharpapi/enums/sharp_api_job_type_enum.py

@@ -0,0 +1,82 @@
+class SharpApiJobTypeEnum:
+    ECOMMERCE_REVIEW_SENTIMENT = {
+        'value': 'ecommerce_review_sentiment',
+        'url': '/ecommerce/review_sentiment',
+    }
+    ECOMMERCE_PRODUCT_CATEGORIES = {
+        'value': 'ecommerce_product_categories',
+        'url': '/ecommerce/product_categories',
+    }
+    ECOMMERCE_PRODUCT_INTRO = {
+        'value': 'ecommerce_product_intro',
+        'url': '/ecommerce/product_intro',
+    }
+    ECOMMERCE_THANK_YOU_EMAIL = {
+        'value': 'ecommerce_thank_you_email',
+        'url': '/ecommerce/thank_you_email',
+    }
+    HR_PARSE_RESUME = {
+        'value': 'hr_parse_resume',
+        'url': '/hr/parse_resume',
+    }
+    HR_JOB_DESCRIPTION = {
+        'value': 'hr_job_description',
+        'url': '/hr/job_description',
+    }
+    HR_RELATED_SKILLS = {
+        'value': 'hr_related_skills',
+        'url': '/hr/related_skills',
+    }
+    HR_RELATED_JOB_POSITIONS = {
+        'value': 'hr_related_job_positions',
+        'url': '/hr/related_job_positions',
+    }
+    TTH_REVIEW_SENTIMENT = {
+        'value': 'tth_review_sentiment',
+        'url': '/tth/review_sentiment',
+    }
+    TTH_TA_PRODUCT_CATEGORIES = {
+        'value': 'tth_ta_product_categories',
+        'url': '/tth/ta_product_categories',
+    }
+    TTH_HOSPITALITY_PRODUCT_CATEGORIES = {
+        'value': 'tth_hospitality_product_categories',
+        'url': '/tth/hospitality_product_categories',
+    }
+    CONTENT_DETECT_PHONES = {
+        'value': 'content_detect_phones',
+        'url': '/content/detect_phones',
+    }
+    CONTENT_DETECT_EMAILS = {
+        'value': 'content_detect_emails',
+        'url': '/content/detect_emails',
+    }
+    CONTENT_DETECT_SPAM = {
+        'value': 'content_detect_spam',
+        'url': '/content/detect_spam',
+    }
+    CONTENT_SUMMARIZE = {
+        'value': 'content_summarize',
+        'url': '/content/summarize',
+    }
+    CONTENT_KEYWORDS = {
+        'value': 'content_keywords',
+        'url': '/content/keywords',
+    }
+    CONTENT_TRANSLATE = {
+        'value': 'content_translate',
+        'url': '/content/translate',
+    }
+    CONTENT_PARAPHRASE = {
+        'value': 'content_paraphrase',
+        'url': '/content/paraphrase',
+    }
+    CONTENT_PROOFREAD = {
+        'value': 'content_proofread',
+        'url': '/content/proofread',
+    }
+    SEO_GENERATE_TAGS = {
+        'value': 'seo_generate_tags',
+        'url': '/seo/generate_tags',
+    }
+

sharpapi_python_client-1.0.0/src/sharpapi/enums/sharp_api_languages.py

@@ -0,0 +1,82 @@
+class SharpApiLanguages:
+    AFRIKAANS = 'Afrikaans'
+    ALBANIAN = 'Albanian'
+    AMHARIC = 'Amharic'
+    ARABIC = 'Arabic'
+    ARMENIAN = 'Armenian'
+    AZERBAIJANI = 'Azerbaijani'
+    BENGALI = 'Bengali'
+    BOSNIAN = 'Bosnian'
+    BULGARIAN = 'Bulgarian'
+    BURMESE = 'Burmese'
+    CATALAN = 'Catalan'
+    CHINESE_SIMPLIFIED = 'Chinese (Simplified)'
+    CHINESE_TRADITIONAL = 'Chinese (Traditional)'
+    CROATIAN = 'Croatian'
+    CZECH = 'Czech'
+    DANISH = 'Danish'
+    DARI = 'Dari'
+    DUTCH = 'Dutch'
+    ENGLISH = 'English'
+    ESTONIAN = 'Estonian'
+    FINNISH = 'Finnish'
+    FRENCH = 'French'
+    GEORGIAN = 'Georgian'
+    GERMAN = 'German'
+    GREEK = 'Greek'
+    GUJARATI = 'Gujarati'
+    HEBREW = 'Hebrew'
+    HINDI = 'Hindi'
+    HUNGARIAN = 'Hungarian'
+    ICELANDIC = 'Icelandic'
+    INDONESIAN = 'Indonesian'
+    ITALIAN = 'Italian'
+    JAPANESE = 'Japanese'
+    JAVANESE = 'Javanese'
+    KANNADA = 'Kannada'
+    KAZAKH = 'Kazakh'
+    KINYARWANDA = 'Kinyarwanda'
+    KOREAN = 'Korean'
+    KURDISH_SORANI = 'Kurdish (Sorani)'
+    KYRGYZ = 'Kyrgyz'
+    LAO = 'Lao'
+    LATVIAN = 'Latvian'
+    LITHUANIAN = 'Lithuanian'
+    MACEDONIAN = 'Macedonian'
+    MALAY = 'Malay'
+    MALAYALAM = 'Malayalam'
+    MARATHI = 'Marathi'
+    MONGOLIAN = 'Mongolian'
+    NEPALI = 'Nepali'
+    NORWEGIAN = 'Norwegian'
+    ORIYA = 'Oriya'
+    PASHTO = 'Pashto'
+    PERSIAN = 'Persian'
+    POLISH = 'Polish'
+    PORTUGUESE = 'Portuguese'
+    PUNJABI = 'Punjabi'
+    ROMANIAN = 'Romanian'
+    RUSSIAN = 'Russian'
+    SERBIAN = 'Serbian'
+    SESOTHO = 'Sesotho'
+    SINHALA = 'Sinhala'
+    SLOVAK = 'Slovak'
+    SLOVENIAN = 'Slovenian'
+    SOMALI = 'Somali'
+    SPANISH = 'Spanish'
+    SWAHILI = 'Swahili'
+    SWEDISH = 'Swedish'
+    TAGALOG = 'Tagalog'
+    TAJIK = 'Tajik'
+    TAMIL = 'Tamil'
+    TELUGU = 'Telugu'
+    THAI = 'Thai'
+    TURKISH = 'Turkish'
+    UKRAINIAN = 'Ukrainian'
+    URDU = 'Urdu'
+    UZBEK = 'Uzbek'
+    VIETNAMESE = 'Vietnamese'
+    XHOSA = 'Xhosa'
+    YORUBA = 'Yoruba'
+    ZULU = 'Zulu'
+

sharpapi_python_client-1.0.0/src/sharpapi/enums/sharp_api_voice_tone.py

@@ -0,0 +1,57 @@
+class SharpApiVoiceTone:
+    ADVENTUROUS = 'Adventurous'
+    ACADEMIC = 'Academic'
+    ARTICULATE = 'Articulate'
+    ASSERTIVE = 'Assertive'
+    AUTHORITATIVE = 'Authoritative'
+    CAPTIVATING = 'Captivating'
+    CASUAL = 'Casual'
+    CANDID = 'Candid'
+    COMPELLING = 'Compelling'
+    COMICAL = 'Comical'
+    CULTURED = 'Cultured'
+    ECLECTIC = 'Eclectic'
+    EDUCATIONAL = 'Educational'
+    EFFORTLESS = 'Effortless'
+    ELOQUENT = 'Eloquent'
+    EMPATHETIC = 'Empathetic'
+    EMPOWERING = 'Empowering'
+    ENCOURAGING = 'Encouraging'
+    ENGAGING = 'Engaging'
+    ENLIGHTENING = 'Enlightening'
+    ENTHUSIASTIC = 'Enthusiastic'
+    EXPRESSIVE = 'Expressive'
+    FORMAL = 'Formal'
+    FRIENDLY = 'Friendly'
+    FUNNY = 'Funny'
+    HEARTENING = 'Heartening'
+    HEARTFELT = 'Heartfelt'
+    HUMOROUS = 'Humorous'
+    IMPASSIONED = 'Impassioned'
+    INSPIRATIONAL = 'Inspirational'
+    INSTRUCTIONAL = 'Instructional'
+    INTELLECTUAL = 'Intellectual'
+    INFORMAL = 'Informal'
+    INVENTIVE = 'Inventive'
+    LIVELY = 'Lively'
+    LYRICAL = 'Lyrical'
+    LUXURIOUS = 'Luxurious'
+    MINIMALIST = 'Minimalist'
+    NARRATIVE = 'Narrative'
+    NEUTRAL = 'Neutral'
+    NOSTALGIC = 'Nostalgic'
+    OPTIMISTIC = 'Optimistic'
+    PERSUASIVE = 'Persuasive'
+    PESSIMISTIC = 'Pessimistic'
+    PROVOCATIVE = 'Provocative'
+    QUIRKY = 'Quirky'
+    RESPECTFUL = 'Respectful'
+    SERIOUS = 'Serious'
+    SINCERE = 'Sincere'
+    STORYTELLING = 'Storytelling'
+    SYMPATHETIC = 'Sympathetic'
+    TECH_SAVVY = 'Tech-Savvy'
+    THOUGHTFUL = 'Thoughtful'
+    TOUCHING = 'Touching'
+    WITTY = 'Witty'
+

sharpapi_python_client-1.0.0/src/sharpapi/sharp_api_service.py

@@ -0,0 +1,285 @@
+import time
+import requests
+from urllib.parse import urlparse
+
+from .dto.job_description_parameters import JobDescriptionParameters
+from .dto.sharp_api_job import SharpApiJob
+from .dto.sharp_api_subscription_info import SharpApiSubscriptionInfo
+from .enums.sharp_api_job_status_enum import SharpApiJobStatusEnum
+from .enums.sharp_api_job_type_enum import SharpApiJobTypeEnum
+
+
+class SharpApiService:
+    def __init__(self, api_key, api_base_url='https://sharpapi.com/api/v1', user_agent='SharpAPIPythonClient/1.2.0'):
+        if not api_key:
+            raise ValueError('API key is required.')
+        self.api_key = api_key
+        self.api_base_url = api_base_url
+        self.user_agent = user_agent
+        self.api_job_status_polling_interval = 10  # seconds
+        self.use_custom_interval = False
+        self.api_job_status_polling_wait = 180  # seconds
+
+    def get_headers(self):
+        return {
+            'Authorization': f'Bearer {self.api_key}',
+            'Accept': 'application/json',
+            'User-Agent': self.user_agent,
+        }
+
+    def make_request(self, method, url, data=None, file_path=None):
+        full_url = f'{self.api_base_url}{url}'
+        headers = self.get_headers()
+
+        if method == 'POST':
+            if file_path:
+                files = {'file': open(file_path, 'rb')}
+                response = requests.post(full_url, headers=headers, data=data, files=files)
+            else:
+                response = requests.post(full_url, headers=headers, json=data)
+        else:
+            response = requests.get(full_url, headers=headers, params=data)
+
+        response.raise_for_status()
+        return response.json()
+
+    def parse_status_url(self, response):
+        return response.get('status_url')
+
+    def fetch_results(self, status_url):
+        waiting_time = 0
+
+        while True:
+            response = requests.get(status_url, headers=self.get_headers())
+            response.raise_for_status()
+            response_data = response.json()
+            job_status = response_data['data']['attributes']
+
+            if job_status['status'] in [SharpApiJobStatusEnum.SUCCESS.value, SharpApiJobStatusEnum.FAILED.value]:
+                break
+
+            retry_after = int(response.headers.get('Retry-After', self.api_job_status_polling_interval))
+            if self.use_custom_interval:
+                retry_after = self.api_job_status_polling_interval
+
+            waiting_time += retry_after
+            if waiting_time >= self.api_job_status_polling_wait:
+                break
+
+            time.sleep(retry_after)
+
+        data = response_data['data']
+        url_parts = urlparse(status_url)
+        segments = url_parts.path.strip('/').split('/')
+        if len(segments) == 5:
+            result = data['attributes']['result']
+        else:
+            result = data['attributes']['result']
+
+        return SharpApiJob(
+            id=data['id'],
+            type=data['attributes']['type'],
+            status=data['attributes']['status'],
+            result=result or None
+        )
+
+    def ping(self):
+        response = self.make_request('GET', '/ping')
+        return response
+
+    def quota(self):
+        response = self.make_request('GET', '/quota')
+        if 'timestamp' not in response:
+            return None
+        return SharpApiSubscriptionInfo(response)
+
+    # Include all API methods here, following the structure:
+
+    def parse_resume(self, file_path, language=None):
+        data = {}
+        if language:
+            data['language'] = language
+        response = self.make_request('POST', SharpApiJobTypeEnum.HR_PARSE_RESUME['url'], data, file_path)
+        return self.parse_status_url(response)
+
+    def generate_job_description(self, job_description_parameters):
+        data = job_description_parameters.to_dict()
+        response = self.make_request('POST', SharpApiJobTypeEnum.HR_JOB_DESCRIPTION['url'], data)
+        return self.parse_status_url(response)
+
+    def related_skills(self, skill_name, language=None, max_quantity=None):
+        data = {'content': skill_name}
+        if language:
+            data['language'] = language
+        if max_quantity:
+            data['max_quantity'] = max_quantity
+        response = self.make_request('POST', SharpApiJobTypeEnum.HR_RELATED_SKILLS['url'], data)
+        return self.parse_status_url(response)
+
+    def related_job_positions(self, job_position_name, language=None, max_quantity=None):
+        data = {'content': job_position_name}
+        if language:
+            data['language'] = language
+        if max_quantity:
+            data['max_quantity'] = max_quantity
+        response = self.make_request('POST', SharpApiJobTypeEnum.HR_RELATED_JOB_POSITIONS['url'], data)
+        return self.parse_status_url(response)
+
+    def product_review_sentiment(self, review):
+        data = {'content': review}
+        response = self.make_request('POST', SharpApiJobTypeEnum.ECOMMERCE_REVIEW_SENTIMENT['url'], data)
+        return self.parse_status_url(response)
+
+    def product_categories(self, product_name, language=None, max_quantity=None, voice_tone=None, context=None):
+        data = {'content': product_name}
+        if language:
+            data['language'] = language
+        if max_quantity:
+            data['max_quantity'] = max_quantity
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.ECOMMERCE_PRODUCT_CATEGORIES['url'], data)
+        return self.parse_status_url(response)
+
+    def generate_product_intro(self, product_data, language=None, max_length=None, voice_tone=None):
+        data = {'content': product_data}
+        if language:
+            data['language'] = language
+        if max_length:
+            data['max_length'] = max_length
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        response = self.make_request('POST', SharpApiJobTypeEnum.ECOMMERCE_PRODUCT_INTRO['url'], data)
+        return self.parse_status_url(response)
+
+    def generate_thank_you_email(self, product_name, language=None, max_length=None, voice_tone=None, context=None):
+        data = {'content': product_name}
+        if language:
+            data['language'] = language
+        if max_length:
+            data['max_length'] = max_length
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.ECOMMERCE_THANK_YOU_EMAIL['url'], data)
+        return self.parse_status_url(response)
+
+    def detect_phones(self, text):
+        data = {'content': text}
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_DETECT_PHONES['url'], data)
+        return self.parse_status_url(response)
+
+    def detect_emails(self, text):
+        data = {'content': text}
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_DETECT_EMAILS['url'], data)
+        return self.parse_status_url(response)
+
+    def detect_spam(self, text):
+        data = {'content': text}
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_DETECT_SPAM['url'], data)
+        return self.parse_status_url(response)
+
+    def summarize_text(self, text, language=None, max_length=None, voice_tone=None, context=None):
+        data = {'content': text}
+        if language:
+            data['language'] = language
+        if max_length:
+            data['max_length'] = max_length
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_SUMMARIZE['url'], data)
+        return self.parse_status_url(response)
+
+    def generate_keywords(self, text, language=None, max_quantity=None, voice_tone=None, context=None):
+        data = {'content': text}
+        if language:
+            data['language'] = language
+        if max_quantity:
+            data['max_quantity'] = max_quantity
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_KEYWORDS['url'], data)
+        return self.parse_status_url(response)
+
+    def translate(self, text, language, voice_tone=None, context=None):
+        data = {'content': text, 'language': language}
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_TRANSLATE['url'], data)
+        return self.parse_status_url(response)
+
+    def paraphrase(self, text, language=None, max_length=None, voice_tone=None, context=None):
+        data = {'content': text}
+        if language:
+            data['language'] = language
+        if max_length:
+            data['max_length'] = max_length
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_PARAPHRASE['url'], data)
+        return self.parse_status_url(response)
+
+    def proofread(self, text):
+        data = {'content': text}
+        response = self.make_request('POST', SharpApiJobTypeEnum.CONTENT_PROOFREAD['url'], data)
+        return self.parse_status_url(response)
+
+    def generate_seo_tags(self, text, language=None, voice_tone=None):
+        data = {'content': text}
+        if language:
+            data['language'] = language
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        response = self.make_request('POST', SharpApiJobTypeEnum.SEO_GENERATE_TAGS['url'], data)
+        return self.parse_status_url(response)
+
+    def travel_review_sentiment(self, text):
+        data = {'content': text}
+        response = self.make_request('POST', SharpApiJobTypeEnum.TTH_REVIEW_SENTIMENT['url'], data)
+        return self.parse_status_url(response)
+
+    def tours_and_activities_product_categories(self, product_name, city=None, country=None, language=None, max_quantity=None, voice_tone=None, context=None):
+        data = {'content': product_name}
+        if city:
+            data['city'] = city
+        if country:
+            data['country'] = country
+        if language:
+            data['language'] = language
+        if max_quantity:
+            data['max_quantity'] = max_quantity
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.TTH_TA_PRODUCT_CATEGORIES['url'], data)
+        return self.parse_status_url(response)
+
+    def hospitality_product_categories(self, product_name, city=None, country=None, language=None, max_quantity=None, voice_tone=None, context=None):
+        data = {'content': product_name}
+        if city:
+            data['city'] = city
+        if country:
+            data['country'] = country
+        if language:
+            data['language'] = language
+        if max_quantity:
+            data['max_quantity'] = max_quantity
+        if voice_tone:
+            data['voice_tone'] = voice_tone
+        if context:
+            data['context'] = context
+        response = self.make_request('POST', SharpApiJobTypeEnum.TTH_HOSPITALITY_PRODUCT_CATEGORIES['url'], data)
+        return self.parse_status_url(response)
+