Cross-Entity Search

GET

https://host.com/v2/datasets/odyssey/general/search

GET

/v2/datasets/odyssey/general/search

1 import requests
2 
3 url = "https://host.com/v2/datasets/odyssey/general/search"
4 
5 payload = {
6     "q": "open source software",
7     "entity_type": "company",
8     "limit": 10
9 }
10 headers = {
11     "Authorization": "Bearer <key>",
12     "Content-Type": "application/json"
13 }
14 
15 response = requests.get(url, json=payload, headers=headers)
16 
17 print(response.json())

1 {
2   "query": "open source software",
3   "limit": 10,
4   "results": [
5     {
6       "display_name": "MongoDB, Inc.",
7       "entity_type": "company",
8       "description": "Leading provider of open source database solutions and cloud services.",
9       "entity_id": "company_987654321",
10       "linkedin_url": "https://www.linkedin.com/company/mongodb",
11       "website": "https://www.mongodb.com"
12     },
13     {
14       "display_name": "Dev Ittycheria",
15       "entity_type": "person",
16       "description": "Chief Executive Officer at MongoDB, Inc.",
17       "entity_id": "person_123456789",
18       "linkedin_url": "https://www.linkedin.com/in/dev-ittycheria",
19       "website": null
20     },
21     {
22       "display_name": "Eliot Horowitz",
23       "entity_type": "person",
24       "description": "Chief Technology Officer at MongoDB, Inc.",
25       "entity_id": "person_987654321",
26       "linkedin_url": "https://www.linkedin.com/in/eliothorowitz",
27       "website": null
28     },
29     {
30       "display_name": "Maria Chen",
31       "entity_type": "person",
32       "description": "Senior Software Engineer specializing in database scalability.",
33       "entity_id": "person_192837465",
34       "linkedin_url": "https://www.linkedin.com/in/maria-chen",
35       "website": null
36     }
37   ],
38   "total_results": 4
39 }

Cross-entity search across companies and people.

Returns the company match first, then executives (C-suite) at that company, then other employees.

Supports limit parameter to control results count (default: 25, max: 100).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

Successful Response

querystring

limitintegerDefaults to 10

resultslist of objects

total_resultsintegerDefaults to 0

Errors

422

Unprocessable Entity Error

Authentication

Headers

Response

Errors