Concept Search by Keyword

API to search for concepts by keyword. Returned is matching concepts and their corresponding metadata.

Requirements:

• Authorization Header set to your token
• q [REQUIRED] Comma delimited list of keywords to search concepts
• categories [OPTIONAL] Comma delimited list of categories to limit results by. Possible categories are company, person, place, other

Example Requests:

curl --location --request GET 'https://ceapi.yewno.com/api/concept?q=apple,canada&categories=company,place'
                --header 'Authorization: ___YOUR_AUTH_CODE___'

import requests
url = "https://ceapi.yewno.com/api/concept?q=apple,canada&categories=company,place"
headers = {'Authorization': '___YOUR_AUTH_CODE___'}
response = requests.request("GET", url, headers=headers)
print(response.json())

Response Details:

• cId: Concept's ID
• title: Concept's plain title
• definition: Concept's definition
• category: Concept's category [company, person, place, or other]
• topics: Concept's topic titles, & subtopics (list of dictionaries)

Example Response:

{
    "status": 200,
    "message": "OK",
    "data": [
        {
            "cId": "930ccb849232d29423fd7e4c44d4a89d",
            "title": "Apple Inc.",
            "category": "company",
            "definition": "Apple Inc. is an American multinational technology company headquartered in Cupertino, California that designs, develops, and sells consumer electronics, computer software, and online services. The company's hardware products include the iPhone smartphone, the iPad tablet computer, the Mac personal computers, the iPod portable media player, the Apple Watch smartwatch, Apple",
            "topics": [
                {
                    "title": "Technology & Engineering",
                    "subtopics": [
                        {
                            "title": "Mobile & Wireless Communication"
                        },
                        {
                            "title": "Agricultural Engineering"
                        }
                    ]
                },
                {
                    "title": "Business & Economics",
                    "subtopics": [
                        {
                            "title": "Industries"
                        },
                        {
                            "title": "Economics"
                        },
                        {
                            "title": "Computer & Information Technology"
                        }
                    ]
                },
                {
                    "title": "Computers & Computer Science",
                    "subtopics": [
                        {
                            "title": "Information Systems"
                        },
                        {
                            "title": "Computer Science"
                        },
                        {
                            "title": "Desktop Applications"
                        }
                    ]
                }
            ]
        },
        {
            "cId": "c406fac5adce4abf7cd534369aa1ae3b",
            "title": "Apple Store",
            "category": "company",
            "definition": "Apple Store is a chain of retail stores owned and operated by Apple Inc. The stores sell Mac personal computers, iPhone smartphones, iPad tablet computers, iPod portable media players, Apple Watch smartwatches, Apple TV digital media players, software, and select third-party accessories. The first Apple Stores were originally opened as",
            "topics": [
                {
                    "title": "Business & Economics",
                    "subtopics": [
                        {
                            "title": "Sales & Selling"
                        },
                        {
                            "title": "Economics"
                        }
                    ]
                },
                {
                    "title": "Technology & Engineering",
                    "subtopics": [
                        {
                            "title": "Mobile & Wireless Communication"
                        },
                        {
                            "title": "Agricultural Engineering"
                        }
                    ]
                },
                {
                    "title": "Social Science",
                    "subtopics": [
                        {
                            "title": "Anthropology"
                        },
                        {
                            "title": "Fashion"
                        }
                    ]
                }
            ]
        },
        {
            "cId": "cd6a7b8768528485a0dbcd459185091e",
            "title": "Canada",
            "category": "place",
            "definition": "The instrumental version of the Canadian national anthem, “O Canada.” 

Canada, second largest country in the world in area (after Russia ), occupying roughly the northern two-fifths of the continent of North America . 

Despite Canada’s great size, it is one of the world’s most sparsely populated countries. This fact,",
            "topics": [
                {
                    "title": "Geography",
                    "subtopics": [
                        {
                            "title": "Canada"
                        }
                    ]
                },
                {
                    "title": "History",
                    "subtopics": [
                        {
                            "title": "Politics"
                        },
                        {
                            "title": "Cold War"
                        }
                    ]
                },
                {
                    "title": "Business & Economics",
                    "subtopics": [
                        {
                            "title": "International Economics"
                        },
                        {
                            "title": "Statistics"
                        }
                    ]
                },
                {
                    "title": "Social Science",
                    "subtopics": [
                        {
                            "title": "Indigenous Studies"
                        },
                        {
                            "title": "Emigration & Immigration"
                        }
                    ]
                }
            ]
        },
        {
            "cId": "57d3c3bc1ce69845c1a5d045ec989d1f",
            "title": "Canadian Pacific Railway",
            "category": "company",
            "definition": "The Canadian Pacific Railway (CPR), also known formerly as CP Rail (reporting mark CP) between 1968 and 1996, is a historic Canadian Class I railroad incorporated in 1881. The railroad is owned by Canadian Pacific Railway Limited, which began operations as legal owner in a corporate restructuring in 2001. Headquartered",
            "topics": [
                {
                    "title": "Transportation",
                    "subtopics": [
                        {
                            "title": "Railroads"
                        }
                    ]
                },
                {
                    "title": "Geography",
                    "subtopics": [
                        {
                            "title": "Canada"
                        }
                    ]
                },
                {
                    "title": "Business & Economics",
                    "subtopics": [
                        {
                            "title": "Accounting"
                        },
                        {
                            "title": "Service Industry"
                        },
                        {
                            "title": "Industries"
                        },
                        {
                            "title": "Food Industry"
                        }
                    ]
                }
            ]
        }
    ]
}

curl --location --request GET 'https://ceapi.yewno.com/api/concept?cIds=476432a3e85a0aa21c23f5abd2975a89,8a85fe387e2c50917fb2e7b7087aebd0'
                --header 'Authorization: ___YOUR_AUTH_CODE___'

import requests
url = "https://ceapi.yewno.com/api/concept?cIds=930ccb849232d29423fd7e4c44d4a89d,8a85fe387e2c50917fb2e7b7087aebd0"
headers = {'Authorization': '___YOUR_AUTH_CODE___'}
response = requests.request("GET", url, headers=headers)
print(response.json())

{
    "status": 200,
    "message": "OK",
    "data": [
        {
            "cId": "476432a3e85a0aa21c23f5abd2975a89",
            "title": "Apple",
            "category": "other",
            "definition": "Because of the apple’s fine qualities, it is sometimes called the king of fruits. The hardy apple flourishes over more parts of the Earth than any other fruit tree. Because the fruit keeps for months in cool storage, it was a dependable winter fruit supply before cold storage was developed. 

The glossy red or greenish-yellow fruit is juicy and crisp, with a spicy aroma. It is delicious to eat raw or cooked. Apple juice and cider are popular drinks. Apples also are commercially canned, prepared as jelly or apple butter, and frozen as juice. The apple contains minerals and a fair amount of vitamins; the carbohydrates are readily digested fruit sugars. About one sixth is solid material and the rest water. 

Although there are thousands of varieties of apples, relatively few are raised commercially.",
            "topics": [
                {
                    "title": "Technology & Engineering",
                    "subtopics": [
                        {
                            "title": "Agriculture"
                        },
                        {
                            "title": "Food Science"
                        }
                    ]
                },
                {
                    "title": "Earth Sciences",
                    "subtopics": [
                        {
                            "title": "Environmental Science"
                        },
                        {
                            "title": "Meteorology & Climatology"
                        }
                    ]
                }
            ]
        },
        {
            "cId": "8a85fe387e2c50917fb2e7b7087aebd0",
            "title": "5G",
            "category": "other",
            "definition": "5th generation mobile networks or 5th generation wireless systems, abbreviated 5G, are the proposed next telecommunications standards beyond the current 4G/IMT-Advanced standards. 5G planning aims at higher capacity than current 4G, allowing a higher density of mobile broadband users, and supporting device-to-device, ultra reliable, and massive machine communications. 5G research and development also aims at lower latency than 4G equipment and lower battery consumption, for better implementation of the Internet of things. There is currently no standard for 5G deployments. The Next Generation Mobile Networks Alliance defines the following requirements that a 5G standard should fulfill: Data rates of tens of megabits per second for tens of thousands of users Data rates of 100 megabits per second for metropolitan areas 1 Gb per second simultaneously to many workers on the same office floor Several hundreds of thousands of simultaneous connections for wireless sensors Spectral efficiency significantly enhanced compared to 4G Coverage improved Signalling efficiency enhanced Latency reduced significantly compared to LTE.",
            "topics": [
                {
                    "title": "Computers",
                    "subtopics": [
                        {
                            "title": "Networking"
                        },
                        {
                            "title": "Information Systems"
                        }
                    ]
                },
                {
                    "title": "Technology & Engineering",
                    "subtopics": [
                        {
                            "title": "Telecommunication"
                        },
                        {
                            "title": "Power Resources"
                        }
                    ]
                }
            ]
        }
    ]
}