This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Text Analytics API Reference

A comprehensive collection of text analytics endpoints that include text summarization, classification, named entity relationship (NER) extraction etc.

The new generation of large language models (LLMs) such as GPT3, GPT4, and ChatGPT/GPT 3.5 have revolutionalized the way we analyze text data.

Out base level text classification endpoint includes few dozen topic labels; however if you are interested a more granular text classifier that contains IAB/IPTC + custom taxonomy) that contains over 1900 topics, please email us at info@specrom.com

Our comprehensive text analytics endpoints uses the latest GPT-J and/or GPT3.5/GPT4 models on the back end to analyze all aspects of the news articles.

1 - Text Language Detection

A Job Scanner API endpoint for detecting the language of the input text.

An endpoint for detecting the language of the input text.


import requests

url = "url = "https://job-search15.p.rapidapi.com/"


payload = {
  "api_type": "language_detection",
  "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}


headers = {
  "content-type": "application/json",
  "X-RapidAPI-Key": "API_Key",
  "X-RapidAPI-Host": "job-search15.p.rapidapi.com"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
	
	POST / HTTP/1.1
Content-Type: application/json
X-Rapidapi-Key: API_Key
X-Rapidapi-Host: job-search15.p.rapidapi.com
Host: job-search15.p.rapidapi.com
Content-Length: 192

{
	"api_type": "language_detection",
	"input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}
	
	
Parameter Description
api_type language_detection
input_text The text whose language is to be detected

Output


{"documents":
[
{"Detected_language":
[{"ISO631-1_language_code":"en","normalized_probability":1}]

,"id":"1"}]
}

This endpoint returns a JSON object containing the following elements:

Parameter Description
documents This is a list containing a single dictionary
ISO631-1_language_code two letter detected language code. Take a look at all the language codes here.
normalized_probability Probability estimate (0-1) indicating the level of certainity with the predicted value

2 - Named Entity Extraction

Extract Named Entities from the input text using our API endpoint.

Extract Named Entities from the input text using our API endpoint

Input

import requests

url = "https://job-search15.p.rapidapi.com/"


payload = {
  "api_type": "named_entity_extraction",
  "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}


headers = {
  "content-type": "application/json",
  "X-RapidAPI-Key": "API_key",
  "X-RapidAPI-Host": "job-search15.p.rapidapi.com"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
	
	POST / HTTP/1.1
Content-Type: application/json
X-Rapidapi-Key: API_key
X-Rapidapi-Host: job-search15.p.rapidapi.com
Host: job-search15.p.rapidapi.com
Content-Length: 96

{
    "api_type": "named_entity_extraction",
    "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}
	
	
Parameter Description
api_type named_entity_extraction
input_text input text

Output


[
{
"$69.7 billion": "MONEY"
},
{
"2019": "DATE"
},
{
"more than 98%": "PERCENT"
},
{
"the year": "DATE"
},
{
"Coca Cola": "ORG"
},
{
"8 million": "CARDINAL"
},
{
"earlier this year": "DATE"
},
{
"100": "CARDINAL"
},
{
"$4.2 billion": "MONEY"
},
{
"last year": "DATE"
},
{
"only about 6%": "PERCENT"
},
{
"April 2019": "DATE"
},
{
"COO Sheryl Sandberg": "PERSON"
},
{
"100": "CARDINAL"
}
.
.
.
(Output Truncated)
]

Our API will extract the following entity types.

PERSON - People, including fictional.

NORP - Nationalities or religious or political groups.

FAC - Buildings, airports, highways, bridges, etc.

ORG - Companies, agencies, institutions, etc.

GPE - Countries, cities, states.

LOC - Non-GPE locations, mountain ranges, bodies of water.

PRODUCT - Objects, vehicles, foods, etc. (Not services.)

EVENT - Named hurricanes, battles, wars, sports events, etc.

WORK_OF_ART - Titles of books, songs, etc.

LAW - Named documents made into laws.

LANGUAGE - Any named language.

DATE - Absolute or relative dates or periods.

TIME - Times smaller than a day.

PERCENT - Percentage, including “%”.

MONEY - Monetary values, including unit.

QUANTITY - Measurements, as of weight or distance.

ORDINAL - “first”, “second”, etc.

CARDINAL - Numerals that do not fall under another type.

3 - Summarize Job Descriptions

This endpoint will generate a summary of the entered text. It uses a state of the art LLM based abstractive summarization model.

The summary generated by this API endpoint is Abstractive in nature and will be similar to what you see using ChatGPT/GPT3.5, or other LLMs. If you are looking for our older extractive summarization endpoint, let us know and we can share that with you.

This endpoint will generate an abstractive summary of the entered text. It uses a state of the art LLM based abstractive summarization model.

Input

import requests

url = "https://job-search15.p.rapidapi.com/"


payload = {
  "api_type": "summarization",
  "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}

headers = {
  "content-type": "application/json",
  "X-RapidAPI-Key": "API_key",
  "X-RapidAPI-Host": "job-search15.p.rapidapi.com"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
	
	POST / HTTP/1.1
Content-Type: application/json
X-Rapidapi-Key: API_key
X-Rapidapi-Host: job-search15.p.rapidapi.com
Host: job-search15.p.rapidapi.com
Content-Length: 96

{
    "api_type": "summarization",
    "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}
	
Parameter Description
api_type summarization
input_text Input Text

Output


The recent scandal and dropouts have impacted Facebook's stock price, but advertising still accounts for more than 98% of the company's revenue, with small and medium-sized businesses making up the majority of ad dollars spent. Facebook has 8 million advertisers, and the top 100 brands only contributed about 6% of the platform's ad revenue last year. Despite the controversy, it will take more to stop Facebook's digital advertising juggernaut.

4 - Jobs Classification

Input the fulltext of job description and to classify jobs based on education level, job function, seniority level using our state of the art AI model.

This classifier will extract the job function, education levele etc. using a state of the art LLM model.

Input

import requests

url = "https://job-search15.p.rapidapi.com/"

payload = {
  "api_type": "jobs_classifier",
  "input_text": "Key Expectations:  To create a caring strategy to strengthen relationships with guests and our local community by investing in our unique assets; Food, People, Cows and Influence, by operating as the face of our brand both in the store and in the community. \\n \\n \\n  Community \\n  Oversee food donation program. \\n  Oversee store events including Spirit Nights, Family Nights, Daddy/Daughter Nights, etc. \\n  Oversee and build strategic business partnerships with schools and businesses. \\n  Create processes that protect and build brand awareness, drive sales, and demonstrate the Winning Hearts Everyday strategy. \\n  Manage community request forms in store email. \\n  Lead with real food through sampling and encouraging team members to personalize the customer's experience. \\n \\n \\n \\n  Outside Sales \\n  Own the full-cycle of the catering process. \\n  Collaborate with the Back of House Director to ensure catering material inventory is managed. \\n  Oversee alongside Administrative Coordinator maintenance of catering vehicles (gas, oil change, cleanliness, etc.) \\n  Oversee Additional Distribution Points (ADPs). \\n  Proactively seek new catering business to increase sales and awareness. \\n  Develop a catering sales database. \\n  Collaborate with General Managers to develop and maintain catering sales guidelines. \\n \\n \\n \\n  Marketing \\n  Oversee social media strategy: Facebook, Instagram, Spotlight, & CFA One App. \\n  Develop a quarterly marketing and community outreach calendar. \\n  Oversee Cow Program including identifying opportunities, collaborating with General Managers on scheduling Cow and Handler and maintaining clean uniforms. \\n  Collaborate with General Managers to schedule and execute a monthly Sampling Program. \\n  Manage Community Boards and holiday decor. \\n  Collaborate with the General Manager and Sr. Business Director on monthly budget and tracking. \\n  Identify paid and unpaid (trade or otherwise) advertising and marketing opportunities (Billboards, Sponsorships, Signage, Vehicle Wraps, Events, etc.) \\n  Oversee flower pickup and delivery from Wegmans every 3 weeks and setting up fresh flowers in the dining room \\n  Create a marketing plan and work with the General Manager to execute. \\n \\n \\n  Marketing Manager: (Subject to change) \\n \\n  Must be available and work up to 40 hours per week in the restaurant. \\n  Must be ServeSafe, Choke, and Allergen Certified. \\n  Execute the S.E.R.V.E. Leadership Model. \\n  Lead the team with enthusiasm and passion. \\n  10-12 Hours of admin per week (Subject to operational needs) \\n \\n \\n  REQUIREMENTS \\n \\n  Must be at least 18 years of age upon hire date \\n  Must be eligible to work in the United States \\n  Must have a source of reliable transportation \\n  Must have reliable transportation \\n  Works in fast paced environment \\n  Mobility required during shifts \\n  Must work well under pressure \\n \\n  In our kitchens, we focus on fresh and simple ingredients. And we always have. Since the beginning, we've served chicken that is whole breast meat, with no added fillers or hormones, and we bread it by hand in our restaurants. Produce is delivered fresh to our kitchens several times a week. Salads are chopped and prepared fresh throughout the day. Whole lemons are freshly squeezed in our restaurants and combined with pure cane sugar and water (yep, that\\u2019s all) to make Chick-fil-A Lemonade\\u00ae. It may not be the easy way, but it's the only way we know."
}
headers = {
  "content-type": "application/json",
  "X-RapidAPI-Key": "API_key",
  "X-RapidAPI-Host": "job-search15.p.rapidapi.com"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
	
	POST / HTTP/1.1
Content-Type: application/json
X-Rapidapi-Key: API_key
X-Rapidapi-Host: job-search15.p.rapidapi.com
Host: job-search15.p.rapidapi.com
Content-Length: 96

{
    "api_type": "jobs_classifier",
    "input_text": "Key Expectations:  To create a caring strategy to strengthen relationships with guests and our local community by investing in our unique assets; Food, People, Cows and Influence, by operating as the face of our brand both in the store and in the community. \\n \\n \\n  Community \\n  Oversee food donation program. \\n  Oversee store events including Spirit Nights, Family Nights, Daddy/Daughter Nights, etc. \\n  Oversee and build strategic business partnerships with schools and businesses. \\n  Create processes that protect and build brand awareness, drive sales, and demonstrate the Winning Hearts Everyday strategy. \\n  Manage community request forms in store email. \\n  Lead with real food through sampling and encouraging team members to personalize the customer's experience. \\n \\n \\n \\n  Outside Sales \\n  Own the full-cycle of the catering process. \\n  Collaborate with the Back of House Director to ensure catering material inventory is managed. \\n  Oversee alongside Administrative Coordinator maintenance of catering vehicles (gas, oil change, cleanliness, etc.) \\n  Oversee Additional Distribution Points (ADPs). \\n  Proactively seek new catering business to increase sales and awareness. \\n  Develop a catering sales database. \\n  Collaborate with General Managers to develop and maintain catering sales guidelines. \\n \\n \\n \\n  Marketing \\n  Oversee social media strategy: Facebook, Instagram, Spotlight, & CFA One App. \\n  Develop a quarterly marketing and community outreach calendar. \\n  Oversee Cow Program including identifying opportunities, collaborating with General Managers on scheduling Cow and Handler and maintaining clean uniforms. \\n  Collaborate with General Managers to schedule and execute a monthly Sampling Program. \\n  Manage Community Boards and holiday decor. \\n  Collaborate with the General Manager and Sr. Business Director on monthly budget and tracking. \\n  Identify paid and unpaid (trade or otherwise) advertising and marketing opportunities (Billboards, Sponsorships, Signage, Vehicle Wraps, Events, etc.) \\n  Oversee flower pickup and delivery from Wegmans every 3 weeks and setting up fresh flowers in the dining room \\n  Create a marketing plan and work with the General Manager to execute. \\n \\n \\n  Marketing Manager: (Subject to change) \\n \\n  Must be available and work up to 40 hours per week in the restaurant. \\n  Must be ServeSafe, Choke, and Allergen Certified. \\n  Execute the S.E.R.V.E. Leadership Model. \\n  Lead the team with enthusiasm and passion. \\n  10-12 Hours of admin per week (Subject to operational needs) \\n \\n \\n  REQUIREMENTS \\n \\n  Must be at least 18 years of age upon hire date \\n  Must be eligible to work in the United States \\n  Must have a source of reliable transportation \\n  Must have reliable transportation \\n  Works in fast paced environment \\n  Mobility required during shifts \\n  Must work well under pressure \\n \\n  In our kitchens, we focus on fresh and simple ingredients. And we always have. Since the beginning, we've served chicken that is whole breast meat, with no added fillers or hormones, and we bread it by hand in our restaurants. Produce is delivered fresh to our kitchens several times a week. Salads are chopped and prepared fresh throughout the day. Whole lemons are freshly squeezed in our restaurants and combined with pure cane sugar and water (yep, that\\u2019s all) to make Chick-fil-A Lemonade\\u00ae. It may not be the easy way, but it's the only way we know."
}
	
	
Parameter Description
api_type jobs_classifier
input_text input text

Output


{"job_function": "Customer Service", "education_type": "High School or equivalent", "employment_type": "Full_time", "seniority_level": "Entry level", "department": "Customer Service"}
Parameter Description
job_function
education_type
employment_type
seniority_level
department

5 - Keyword or Keyphrase Extraction

A JobScanner endpoint for extracting keywords or keyphrases from the input text.

This endpoint will take input text and extract the most relevant keywords and keyphrases from the input text.

Currently this model is in beta and only available for English.

Input

import requests

url = "https://job-search15.p.rapidapi.com/"


payload = {
  "api_type": "keyword_extraction",
  "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}

headers = {
  "content-type": "application/json",
  "X-RapidAPI-Key": API_Key,
  "X-RapidAPI-Host": "job-search15.p.rapidapi.com"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
	
	POST / HTTP/1.1
Content-Type: application/json
X-Rapidapi-Key: API_Key
X-Rapidapi-Host: job-search15.p.rapidapi.com
Host: job-search15.p.rapidapi.com
Content-Length: 151

{
    "api_type": "keyword_extraction",
    "input_text": "While the big-name dropouts have dented Facebook's stock price and prompted leadership to address some of the concerns , it'll take a lot more to stop the company's digital advertising juggernaut. Facebook generated $69.7 billion from advertising in 2019, more than 98% of its total revenue for the year. And most of those ad dollars don't come from companies likeand Coca Cola so much as the sprawling list of small and medium-sized businesses who use Facebook to attract customers and build their brands. Facebook has 8 million advertisers, it said earlier this year. Of those, the highest-spending 100 brands accounted for $4.2 billion in Facebook advertising last year, according to data from marketing research firm Pathmatics -- or only about 6% of the platform's ad revenue. The last time Facebook shared that data itself was in April 2019 , when COO Sheryl Sandberg said the top 100 advertisers represented "
}
	
	
Parameter Description
api_type keyword_extraction
input_text input text

Output


[
{"keyphrase":"digital advertising juggernaut","weight":0.01},
{"keyphrase":"dented Facebook stock","weight":0.01},
{"keyphrase":"Facebook stock price","weight":0.01},
{"keyphrase":"company digital advertising","weight":0.01},
{"keyphrase":"big-name dropouts","weight":0.03},
{"keyphrase":"dropouts have dented","weight":0.03},
{"keyphrase":"stock price","weight":0.03},
{"keyphrase":"price and prompted","weight":0.03},
{"keyphrase":"prompted leadership","weight":0.03},
{"keyphrase":"leadership to address","weight":0.03}]
Parameter Description
keyphrase Extracted keyword or keyphrase that is central to the concept/idea/person/company being discussed in the input_text
weight A score (0-1) that indicates the overall weight of that keyword/keyphrase