SharpAPI Flutter Client

AI-Powered Swiss Army Knife API for every software developer

Save countless hours and supercharge your app with AI capabilities in just 2 lines of code.

Save time on repetitive content analysis and generation tasks that your app users perform daily.

See more at SharpAPI.com Website »

What can it do for you?

• E-commerce
  • Quickly generate engaging product introductions to attract customers.
  • Automatically create personalized thank-you emails for enhanced customer experience.
  • Streamline product categorization for a well-organized catalog.
  • Sentiment Analysis: Understand and analyze sentiment in product reviews for data-driven decision-making.
• Content & Marketing Automation
  • Easily translate text for a global audience.
  • Spam Content Detection: Identify and filter out spam content effectively.
  • Contact Information Extraction: Extract phone numbers and email addresses from non-standard formats for streamlined communication.
  • Generate concise summaries and unique keywords/tags for improved content consumption.
  • Boost SEO efforts by automatically generating META tags based on content.
• HR Tech
  • Generate complex job descriptions effortlessly, saving time in the hiring process.
  • Skills and Position Insights: Identify related job positions and skills to streamline recruitment.
  • Automated Resume Parsing: Efficiently parse and extract information from resumes files for easy processing.
• Travel, Tourism & Hospitality
  • Analyze sentiment in travel reviews to improve services.
  • Streamline categorization for tours, activities, and hospitality products.

Features

Please refer to the official:

• API Documentation
• Multi-language Support: Supporting 80 languages for every content or data analysis API endpoint. Check the list here.
• Easy-to-Use RESTful Format: With standardized set of endpoints - gain valuable insights through analysis endpoints, covering product categories, skills, and job positions, providing relevant scores.
• Always the same, clean data formats: Rest assured with consistent, predictable JSON format for all returned data. No need to worry about fuzzy AI data.
• Tech Support: Crafted by developers for developers, we provide continuous assistance throughout your journey.

Installation

1. Add sharpapi_flutter_client to your pubspec.yaml file

   dependencies:
     sharpapi_flutter_client: ^latest_version
   

2. Run flutter pub get to install the package.

3. Register at SharpApi.com and get the API key. That's it!

Usage

1. Import the package in your dart file

   import 'package:sharpapi_flutter_client/sharpapi_flutter_client.dart';
   

2. Initialize the SharpApiConfigs with your API key in the main method

   void main() {
     SharpApiConfigs.init(
       apiKey: 'YOUR_API_KEY',
     );
   
     runApp(const MyApp());
   }
   

Each call usually takes somewhere between a couple of seconds to a minute.

After that period a returned response will usually have success status and it's results will be available for further processing. Each API method returns different return format. Go to List of API methods/endpoints below for details»

Our API guarantees to return correct format every time. AI engines that SharpAPI use in rare cases have a tendency to misbehave and timeout or return incorrect data. In those cases the returned status for the job will be failed. You can rerun the exact same job request in that case.

As long as the job is still being processed by our engine it will keep returning pending status.

List of API methods/endpoints

For methods that have language parameter you can also use SharpApiLanguages Enum values to make your code more readable.

HR

Parse Resume/CV File

Parses a resume (CV) file from multiple formats (PDF/DOC/DOCX/TXT/RTF) and returns an extensive object of data points.

An optional output language parameter can also be provided (English value is set as the default one) .

  ///*** parse resume
  SharpApi.parseResume(
    resume: File(''),
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Generate Job Description

Based on the list of extensive parameters this endpoint provides concise job details in the response format, including the short description, job requirements, and job responsibilities. The only mandatory parameter is name.

  ///*** generate job description
  SharpApi.generateJobDescription(
    name: 'ANY_JOB_TITLE',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Related Skills

Generates a list of related skills with their weights as a float value (1.0-10.0) where 10 equals 100%, the highest relevance score.

  ///*** related skills
  SharpApi.relatedSkills(
    skill: 'ANY_SKILL',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Related Job Positions

Generates a list of related job positions with their weights as float value (1.0-10.0) where 10 equals 100%, the highest relevance score.

  ///*** related job positions
  SharpApi.relatedJobPositions(
    jobTitle: 'ANY_JOB_TITLE',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

E-commerce

Product Review Sentiment

Parses the customer's product review and provides its sentiment (POSITIVE/NEGATIVE/NEUTRAL) with a score between 0-100%. Great for sentiment report processing for any online store.

  ///*** product review sentiment
  SharpApi.productReviewSentiment(
    content: 'ANY_CONTENT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Product Categories

Generates a list of suitable categories for the product with relevance weights as a float value (1.0-10.0) where 10 equals 100%, the highest relevance score. Provide the product name and its parameters to get the best category matches possible. Comes in handy with populating product catalogue data and bulk products' processing.

  ///*** product categories
  SharpApi.productCategories(
    content: 'ANY_CONTENT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Generate Product Intro

Generates a shorter version of the product description. Provide as many details and parameters of the product to get the best marketing introduction possible. Comes in handy with populating product catalog data and bulk products processing.

  ///*** generate product intro
  SharpApi.generateProductIntro(
    content: 'ANY_CONTENT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Generate Thank You E-mail

Generates a personalized thank-you email to the customer after the purchase. The response content does not contain the title, greeting or sender info at the end, so you can personalize the rest of the email easily.

  ///*** generate thank you email
  SharpApi.generateThankYouEmail(
    content: 'ANY_CONTENT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Content

Translate Text

Translates provided text to selected language. 80 languages are supported. Please check included SharpApiLanguages Enum class for details.

  ///*** translate text
  SharpApi.translate(
    text: 'ANY_TEXT',
    language: 'ANY_LANGUAGE', // user language string from [SharpApiLanguages] class
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Detect Spam

Checks if provided content passes a spam filtration test. Provides a percentage confidence score and an explanation for whether it is considered spam or not. This information is useful for moderators to make a final decision.

  ///*** detect spam
  SharpApi.detectSpam(
    text: 'ANY_TEXT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Detect Phones Numbers

Parses the provided text for any phone numbers and returns the original detected version and its E.164 format. Might come in handy in the case of processing and validating big chunks of data against phone numbers or f.e. if you want to detect phone numbers in places where they're not supposed to be.

  ///*** detect phones
  SharpApi.detectPhones(
    text: 'ANY_TEXT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Detect Emails

Parses the provided text for any possible emails. Might come in handy in case of processing and validating big chunks of data against email addresses or f.e. if you want to detect emails in places where they're not supposed to be.

  ///*** detect emails
  SharpApi.detectEmails(
    text: 'ANY_TEXT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Generate Keywords/Tags

Generates a list of unique keywords/tags based on the provided content.

  ///*** generate keywords
  SharpApi.generateKeywords(
    text: 'ANY_TEXT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Summarize Text

Generates a summarized version of the provided content. Perfect for generating marketing introductions of longer texts.

  ///*** summarize text
  SharpApi.summarizeText(
    text: 'ANY_TEXT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

SEO

Generate SEO Tags

Generates all most important META tags based on the content provided. Make sure to include link to the website and pictures URL to get as many tags populated as possible.

  ///*** generate seo tags
  SharpApi.generateSeoTags(
    content: 'ANY_CONTENT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Travel, Tourism & Hospitality

Travel Review Sentiment

Parses the Travel/Hospitality product review and provides its sentiment (POSITIVE/NEGATIVE/NEUTRAL) with a score between 0-100%. Great for sentiment report processing for any online store.

  ///*** travel review sentiment
  SharpApi.travelReviewSentiment(
    content: 'ANY_CONTENT',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Tours & Activities Product Categories

Generates a list of suitable categories for the Tours & Activities product with relevance weights as float value (1.0-10.0) where 10 equals 100%, the highest relevance score. Provide the product name and its parameters to get the best category matches possible. Comes in handy with populating product catalogue data and bulk product processing. Only first parameter productName is required.

  ///*** tours and activities product categories
  SharpApi.toursAndActivitiesProductCategories(
    productName: 'ANY_PRODUCT_NAME',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Hospitality Product Categories

Generates a list of suitable categories for the Hospitality type product with relevance weights as float value (1.0-10.0) where 10 equals 100%, the highest relevance score. Provide the product name and its parameters to get the best category matches possible. Comes in handy with populating products catalogs data and bulk products' processing. Only first parameter productName is required.

  ///*** hospitality product categories
  SharpApi.hospitalityProductCategories(
    productName: 'ANY_PRODUCT_NAME',
  ).then((value) {
    /// do something with the [value] here
  }).catchError((error) {
    /// do something with the [error] here
  });

Do you think our API is missing some obvious functionality?

Please let us know»

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Abdullah Mansour

License

The MIT License (MIT). Please see License File for more information.