‍

Getting started 

Before integrating the Autosuggest API, you must authenticate and generate a token. You can test the API using the API Demo page, where you can also download a JavaScript demo app to test it directly in your browser.

Additionally, you can use the MCP server to test MAPEGY APIs.

‍

Autosuggest/Query 

This function transforms simple user inputs into structured, complex lexical search queries focused on a single topic or organization without requiring manual keyword expansion. This makes it easy to retrieve precise data from other MAPEGY APIs without requiring users to manually construct complex query strings or expand keywords.

Results are delivered in JSON format. 

Make Requests

To interact with the API, you must send HTTP GET or POST requests to the API endpoint using the default content type. Every request needs a token.

• API endpoint: https://api.mapegy.com
• Route: /Autossugest/Query/
• Content-Type: application/x-www-form-urlencoded

Required parameters:

• Query: Your search string (e.g. “Artificial intelligence”) 
• Mode: Choose Topic or Organization based on the type of query you want to build.

How to phrase queries to get optimal results?
For the best performance and accuracy, make your prompts as specific as possible rather than using broad or generic topics. Focused queries allow the retrieval system to pinpoint relevant documents faster and significantly reduce the likelihood of request timeouts.

Example: Access the Autosuggest/Query function with a valid token

• Route: /Autosuggest/Query/
• Method: GET or POST
• Content-Type: application/x-www-form-urlencoded
• Mandatory parameters: query, mode
• Example GET request:
  /Autosuggest/Query?query=Artificial%20intelligence&mode=TOPIC&token=b6c7ZuPSDgWDnFHXiRxHyhSTLIYLlVIMG0RCLO95WAMfjeDH4qLA6M3DgIGb6NQM
• ‍Example response suggested query: 

{
  "scout_query": {
    "format_version": "1.6.0",
    "data": {
      "topics": [
        [
          "artificial intelligence",
          "\"AI\"",
          "machine intelligence",
          "intelligent system",
          "cognitive computing"
        ]
      ]
    }
  },
  "suggestions": {
    "topics": [
      [
        "machine learning",
        "deep learning",
        "neural network",
        "computer vision",
        "natural language processing",
        "\"NLP\"",
        "expert system",
        "reinforcement learning",
        "generative AI",
        "autonomous agent",
        "robotics",
        "knowledge representation",
        "decision support",
        "pattern recognition",
        "data mining",
        "predictive analytics",
        "intelligent automation",
        "speech recognition",
        "image recognition",
        "conversational AI"
      ]
    ]
  },
  "title": "Artificial intelligence"
}

‍

‍

Autosuggest/Topics and Autosuggest/Organizations

This function improves your search functionality by providing topic or organization suggestions based on user input.

Results are delivered in JSON format.

Enter a term to receive suggested topics and organizations, along with metadata such as descriptions and web links.
This API is especially valuable for creating better search experiences. For example, in our SCOUT query builder, users can input a topic and receive related topic suggestions to refine their complex queries.

‍

‍

Make Requests

To interact with the API, you must send HTTP GET or POST requests to the API endpoint using the default content type. Every request needs a token.

• API Endpoint: https://api.mapegy.com
• Content-Type: application/x-www-form-urlencoded

There are two endpoints for topics and organizations suggestions:

• Autosuggest/Topics/?query=  Provides topic suggestions based on your input.
• Autosuggest/Organizations/?query= Provides organization name suggestions based on your input.

Required parameter for both endpoints is query. Enter a keyword to receive relevant suggestions.

Optional Parameters:

• limit: Restricts the number of suggestions, just enter a number from 1 to 10.
• include: Specifies which response fields to retrieve. List the desired response fields, separated by commas. To view all available fields, run a query without specifying this parameter.
• For organization autosuggestions, you can further filter results by organization type: Companies, Startups, Hospitals, Government, Groups, and Investees.

Example: Access the Autosuggest API with a valid token

• Route: /Autosuggest/Topics/
• Method: GET or POST
• Content-Type: application/x-www-form-urlencoded
• Mandatory parameters: query, token
• Optional parameters used: limit, include
• Example GET request: https://api.mapegy.com/Autosuggest/Topics/?query=Fuel&token=fr9Ch_2BDFI-rBR6edo0Lb-0JRVP6lBb5Fb7p4FYND0Xnlk_2NpNNcJ1IAYlO3SL&limit=5&include=term,description,web_links 
• ‍Example response suggested topic:

[
  {
    "term": "Fuel cell",
    "topic_id": 5693111,
    "web_links": {
      "images": [
        "https://upload.wikimedia.org/wikipedia/commons/thumb/2/22/Fuel_cell_NASA_p48600ac.jpg/300px-Fuel_cell_NASA_p48600ac.jpg"
      ],
      "wikipedia": "https://en.wikipedia.org/?curid=11729"
    },
    "description": "A fuel cell is a device that converts the chemical energy from a fuel into electricity through a chemical reaction of positively charged hydrogen ions with oxygen or another oxidizing agent. Fuel cells are different from batteries in requiring a continuous source of fuel and oxygen or air to sustain the chemical reaction, whereas in a battery the chemicals present in the battery react with each other to generate an electromotive force (emf). Fuel cells can produce electricity continuously for as long as these inputs are supplied. The first fuel cells were invented in 1838. The first commercial use of fuel cells came more than a century later in NASA space programs to generate power for satellites and space capsules. Since then, fuel cells have been used in many other applications. Fuel cells are used for primary and backup power for commercial, industrial and residential buildings and in remote or inaccessible areas.",
    "language_code": "EN",
    "score_relevance": 0.421,
    "web_links_broken": {}
  }
]

‍

Autosuggest/Portfolio 

This function identifies relevant topics and organizations specific to a given company's innovation portfolio based on an organization URL and category.

This is helpful to populate users’ profiles with relevant content for them. 

Results are delivered in JSON format. 

Make Requests

To interact with the API, you must send HTTP GET or POST requests to the API endpoint using the default content type. Every request needs a token.

• API endpoint: https://api.mapegy.com
• Route: /Autosuggest/Portfolio/ 
• Content-Type: application/x-www-form-urlencoded

Required parameters:

• organization_url: Enter the web address of the organization to discover its relevant categories. 
• category: Choose from the following categories to retrieve related topics or organizations: Technological DNA; Product, Services, Applications; Market & Industries, Emerging Technologies, Trends, Competitors, New Entrants, Suppliers & Partners. 

Example: Access the Autosuggest/Portfolio function with a valid token

• Route: /Autosuggest/Portfolio/
• Method: GET or POST
• Content-Type: application/x-www-form-urlencoded
• Mandatory parameters: organization_url, category 
• Example GET request:
  /Autosuggest/Portfolio?organization_url=spacex.com&category=Markets%20%26%20Industries&token=b6c7ZuPSDgWDnFHXiRxHyhSTLIYLlVIMG0RCLO95WAMfjeDH4qLA6M3DgIGb6NQM
• ‍Example response suggested query: 

{
  "projects": [
    {
      "title": "Satellite Telecommunications",
      "description": "Provision of satellite-based broadband internet and communication services.",
      "type": "topic"
    },
    {
      "title": "Space Launch Services",
      "description": "Commercial and government satellite and cargo launch services using reusable rockets.",
      "type": "topic"
    },
    {
      "title": "Human Spaceflight",
      "description": "Crewed space missions including transport to the International Space Station and beyond.",
      "type": "topic"
    },
    {
      "title": "Space Exploration",
      "description": "Development of technologies and missions aimed at exploring the Moon, Mars, and deep space.",
      "type": "topic"
    },
    {
      "title": "Aerospace Manufacturing",
      "description": "Design and manufacture of rockets, spacecraft, and related aerospace components.",
      "type": "topic"
    }
  ]
}