question

Upvotes
Accepted
wangbin avatar image
7 ●1 ●0 ●2

PermID search API cannot find some available organizations

I find that PermID search API cannot find some organizations that can be found by the search UI on PermID.org website. Here are 2 examples. Do you know the reason?

  1. Kidsland International Holdings Ltd, https://permid.org/1-5056412074. The API returns empty result.
  2. Wah Sun Handbags International Holdings Ltd, https://permid.org/1-5056414599. The API returns as follow but the correct entity is not in the return result.


{"result":{"organizations":{"entityType":"organizations","total":10,"start":1,"num":5,"entities":[{"@id":"https:\/\/permid.org\/1-5001102230","organizationName":"Sun Wah Group","orgSubtype":"Unknown","hasURL":"http:\/\/www.sunwahgroup.com\/"},{"@id":"https:\/\/permid.org\/1-5040194820","organizationName":"Wah Sun Investments Ltd","orgSubtype":"Unknown"},{"@id":"https:\/\/permid.org\/1-5065315137","organizationName":"H SUN HOLDING ApS","orgSubtype":"Unknown"},{"@id":"https:\/\/permid.org\/1-5050308375","organizationName":"Sun Wah Capital Ltd","orgSubtype":"Unknown"},{"@id":"https:\/\/permid.org\/1-5050272689","organizationName":"Sun Wah Education Laboratories Inc","orgSubtype":"Unknown"}]}}}

intelligent-tagging-apipermid-apiopen-permid-api
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

3 Answers

Upvotes
Accepted
Jirapongse avatar image
38.1k ●71 ●35 ●53

@wangbin

I got a response from the Open PermID team.

Few organization entities are configured with the name parameter. In this case, "Kidsland" is not configured with the name parameter. Therefore, you are unable to search it with the name parameter.

To search organizations by name, you can use search without the name parameter.

icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Upvotes
Jirapongse avatar image
38.1k ●71 ●35 ●53

@wangbin

Could you please share the query (q) used in the search API?

From my test, it returns data properly.

The above query is Kidsland and it returns.


{
  "result": {
    "organizations": {
      "entityType": "organizations",
      "total": 2,
      "start": 1,
      "num": 2,
      "entities": [
        {
          "@id": "https://permid.org/1-5056412074",
          "organizationName": "Kidsland International Holdings Ltd",
          "primaryTicker": "2122",
          "orgSubtype": "Investment Company",
          "hasHoldingClassification": "publiclyHeld",
          "hasURL": "https://www.kidslandholdings.com/"
        },
        {
          "@id": "https://permid.org/1-5074089229",
          "organizationName": "Kidsland Manufacturing Co Ltd",
          "orgSubtype": "Unknown"
        }
      ]
    }
  }
}

For the second question, you need to specify the num parameter to get more results.

The Open PermID swagger is avaiable at https://developers.refinitiv.com/open-permid/permid-entity-search/dev-tools.


1587464137987.png (43.3 KiB)
1587464319586.png (38.4 KiB)
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

wangbin avatar image wangbin

I use the Search API with name parameter only. And the input name is full name instead of just a "kidsland". Here is the full query, {'format': 'JSON', 'entityType': 'organization', 'q': 'name:Kidsland International Holdings Ltd'}

wangbin avatar image wangbin

I use the Search API with name parameter only. And the input name is full name instead of just a "kidsland". Here is the full query, {'format': 'JSON', 'entityType': 'organization', 'q': 'name:Kidsland International Holdings Ltd'}. So the issue is "cannot find the entity by searching with full name as the name parameter"

Upvotes
Jirapongse avatar image
38.1k ●71 ●35 ●53

Yes, you are correct. It doesn't work when using the name parameter with "Kidsland". However, it works if I search for "Kidsland" without any parameter.

Next, I will contact the Open PermID team to verify this problem.



icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Click below to post an Idea Post Idea