⚓Search Public Engines

Step-by-Step guide for searching within Public Engines

Prerequisites

• Register with Sepana

• Create an API key (API keys can be viewed here).

Steps

Fetch API key

This step requires a user to fetch a valid API key from their Sepana dashboard. For this particular example, we will be copying the API key with the name "read-only-key" displayed in the above image. Click on to copy the API key.

API_KEY = "Gh_rNsAhI-9Ws2BbmqrJpZ49pFkUZuZtsrE_FEg5N5Wce6hAQZoCpQ"

List Public Engines

Use the API key obtained in the previous section to list the available Public Engines within Sepana. The List Public Engines endpoint can be used to fetch this.

Request

curl --location --request GET \
'https://api.sepana.io/v1/engine/public/list' \
--header 'x-api-key: Gh_rNsAhI-9Ws2BbmqrJpZ49pFkUZuZtsrE_FEg5N5Wce6hAQZoCpQ'

Response

[
  {
    "engine_id": "ffea4660-9829-4a56-acf7-eb74b259c372",
    "engine_name": "blockchain-authority",
    "namespace": "d9601b27-e91b-4987-a664-ec9af8769e63",
    "network": "",
    "total_records": 3000,
    "total_size": 70590,
    "created_at": {
      "val": "12/01/2022 12:11:23 PM ",
      "_spec_type": "<class 'datetime.datetime'>"
    }
  },
  {
    "engine_id": "2fa05f86-b999-4be3-9daa-6fd62f381e75",
    "engine_name": "ethglobal-work",
    "namespace": "5ef7b76f-800c-4051-b32c-46d75e4ffeea",
    "network": "",
    "total_records": 940,
    "total_size": 2080,
    "created_at": {
      "val": "12/01/2022 05:24:50 AM ",
      "_spec_type": "<class 'datetime.datetime'>"
    }
  },
  ....
]

Select Public Engines

Next, you can choose the Engine of interest from the list obtained in previous section.

Here, we are choosing ffea4660-9829-4a56-acf7-eb74b259c372 (blockchain-authority) and 2fa05f86-b999-4be3-9daa-6fd62f381e75 (ethglobal-work)

Search

Now, that you have the API key and engine ids of the selected Engines. You can now perform "Search".

Request

curl --location --request POST 'https://api.sepana.io/v1/search' \
--header 'x-api-key: Gh_rNsAhI-9Ws2BbmqrJpZ49pFkUZuZtsrE_FEg5N5Wce6hAQZoCpQ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "engine_ids": [
        "ffea4660-9829-4a56-acf7-eb74b259c372",
        "2fa05f86-b999-4be3-9daa-6fd62f381e75"
    ],
    "query": {
        "query_string": {
            "query": "india"
        }
    },
    "size": 2,
    "page": 0
}
'

Response

{
    "hits": {
        "total": {
            "value": 4,
            "relation": "eq"
        },
        "max_score": 0.2876821,
        "hits": [
            {
                "_index": "ffea4660-9829-4a56-acf7-eb74b259c372",
                "_type": "_doc",
                "_id": "RfEFzoQBxqv6fmT099iM",
                "_score": 0.2876821,
                "_source": {
                    "Stages": "Series A",
                    "Date": "2021-08-31T00:00:00.000Z",
                    "Investors": "Accel,Bertelsmann India Investments",
                    "Description": "Decentralized personal loans marketplace",
                    "Founder": "Mayank Tewari,Prerit Srivastava",
                    "Website": "https://www.skeps.com/",
                    "Project": "Skeps",
                    "Category": "CeFi",
                    "Sub-categories": "Lending/Borrowing",
                    "Announcement": "",
                    "Fundraising Round": "Skeps - Series A",
                    "Record ID": "recufCOPL5Y7csrNj",
                    "Name": "Skeps",
                    "category_name": "CeFi",
                    "subcategory_name": "Lending/Borrowing",
                    "fundraising_round": "Skeps - Series A",
                    "Investors_name": "Accel, Bertelsmann India Investments",
                    "founders_name": "Mayank Tewari, Prerit Srivastava",
                    "Created": "2021-09-06T08: 22:21.000Z",
                    "Amount": "9500000",
                    "Investors copy": "",
                    "Valuation": ""
                }
            },
            {
                "_index": "2fa05f86-b999-4be3-9daa-6fd62f381e75",
                "_type": "_doc",
                "_id": "RvELzoQBxqv6fmT0odgB",
                "_score": 0.13353139,
                "_source": {
                    "indicator": {
                        "id": "NY.GDP.MKTP.CD",
                        "value": "GDP (current US$)"
                    },
                    "country": {
                        "id": "IN",
                        "value": "India"
                    },
                    "countryiso3code": "IND",
                    "date": "2021",
                    "value": 3173397590816.91,
                    "unit": "",
                    "obs_status": "",
                    "decimal": 0
                }
            }
        ]
    },
    "aggregations": null
}