/api/pathfinding

This route can be used to find multi-connection paths from one node to another. This is implemented using the shortest path algorithm on the web of connections.

Usage

Examples:

GET Basic Names Search:
http://96.241.186.201:5173/api/pathfinding?api_key=your-api-key&source_name=Tesla&target_name=Raytheon

Query Parameters:

ParamRequired?Example ValueDescription
api_keyRequiredGp41Z-GgyZQ9fyIa3uWy0N-HRKD1b9ouui2qhAs26QkYour API Key, found on your account page. This can also be provided under the X-API-KEY header.
path_limitOptional5
(Defaults to 3)		Number of paths to return.
source_name

OR

source_uuid		OptionalRaytheonName of the path start node.
9aba98c5-d74f-4311-b22d-91a3404c44b6UUID of the path start node.
target_name

OR

target_uuid		OptionalLockheed MartinName of the path end node.
7a780507-d8f4-41d8-ab6a-a67475d1c56aUUID of the path end node.
connection_typeOptionalCoop, Oppo, Legal, Deal, GoodsTran, Sanction, Merger, Acquisition, IsPartOf, IsA, HasTitle, Competitors, EquivalentTo, BetterThan, IsSubclassOf, WorksFor, Owns, OperatesIn, IsFrom, Uses, Produces, Affects, Prevents, ParticipatesIn, KnownAssociatesConnection type filter. Paths will only be formed through connections of the specified types.

Multiple values can be comma-delimited or entered as separate query params.
entity_typeOptionalORG, PRODUCT, GPE, PERSON, TITLE, FAC, TECHNOLOGY, LAW, LOC, NORP, THREAT, EVENTEntity type filter. Paths will only be formed through entities of the specified types.

Multiple values can be comma-delimited or entered as separate query params.
min_dateOptional2024-05-30Paths will only be formed through connections after this date.

Can be a very strict filter, as many articles do not publish parseable dates.
max_dateOptional2025-01-26Paths will only be formed through connections before this date.

Can be a very strict filter, as many articles do not publish parseable dates.

Result Format

Below is an example output of this route.

  • "rows_returned" is how many rows were billed in the completion of the request.
  • This output represents 4 paths of length 2 between Raytheon and China.
  • Many of the nodes/edges are re-used in different paths, but you are only billed for the total unique nodes/edges.

{
    "rows_returned": 9,
    "source_node": {
        "ent_name": "Raytheon",
        "ent_type": "ORG",
        "ent_uuid": "b2729e25-3a1d-49ff-88f5-39bd1e9ab9ee",
        "ent_aliases": []
    },
    "target_node": {
        "ent_name": "China",
        "ent_type": "GPE",
        "ent_uuid": "f1ee5a5d-c44f-41fc-ad38-d59ac69ca848",
        "ent_aliases": []
    },
    "path_length": 2,
    "paths": [
        [
            {
                "source_entity": {
                    "ent_name": "Raytheon",
                    "ent_type": "ORG",
                    "ent_uuid": "b2729e25-3a1d-49ff-88f5-39bd1e9ab9ee",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "Coop",
                    "article_title": "Ursa Major Boosts Solid Rocket Expansion With Raytheon Tests",
                    "article_url": "https://aviationweek.com/defense/missile-defense-weapons/ursa-major-boosts-solid-rocket-expansion-raytheon-tests",
                    "article_site": "https://aviationweek.com/",
                    "article_date": "2024-12-18",
                    "context": "The Army program with Raytheon “went from concept and design to firing and"
                },
                "target_entity": {
                    "ent_name": "Army",
                    "ent_type": "ORG",
                    "ent_uuid": "ceaed5d8-3427-456f-ae81-ac566e2cac37",
                    "ent_aliases": []
                }
            },
            {
                "source_entity": {
                    "ent_name": "Army",
                    "ent_type": "ORG",
                    "ent_uuid": "ceaed5d8-3427-456f-ae81-ac566e2cac37",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "OperatesIn",
                    "article_title": "US applies double standards on nuclear issue: Defense Spokesperson - China Military",
                    "article_url": "http://eng.chinamil.com.cn/VOICES/MinistryofNationalDefense_209794/16348744.html",
                    "article_site": "http://eng.chinamil.com.cn/",
                    "article_date": "undefined-undefined-undefined",
                    "context": "said that China was accelerating and expanding nuclear arsenal of its Army, Navy and Air Force"
                },
                "target_entity": {
                    "ent_name": "China",
                    "ent_type": "GPE",
                    "ent_uuid": "f1ee5a5d-c44f-41fc-ad38-d59ac69ca848",
                    "ent_aliases": []
                }
            }
        ],
        [
            {
                "source_entity": {
                    "ent_name": "Raytheon",
                    "ent_type": "ORG",
                    "ent_uuid": "b2729e25-3a1d-49ff-88f5-39bd1e9ab9ee",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "Deal",
                    "article_title": "Raytheon scores engineering and development contract for extended range airborne electronic attack pod",
                    "article_url": "https://defensescoop.com/2024/10/02/raytheon-scores-engineering-and-development-contract-for-extended-range-airborne-electronic-attack-pod/",
                    "article_site": "https://defensescoop.com/",
                    "article_date": "2024-10-02",
                    "context": "The Navy awarded Raytheon"
                },
                "target_entity": {
                    "ent_name": "Navy",
                    "ent_type": "ORG",
                    "ent_uuid": "03d4e2ba-84c2-4f24-8513-9f4cf74e20bc",
                    "ent_aliases": []
                }
            },
            {
                "source_entity": {
                    "ent_name": "Navy",
                    "ent_type": "ORG",
                    "ent_uuid": "03d4e2ba-84c2-4f24-8513-9f4cf74e20bc",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "Oppo",
                    "article_title": "How the Navy’s vision to enhance readiness and lethality by 2027 hinges on technology",
                    "article_url": "https://defensescoop.com/2025/04/07/james-kilby-navy-technology-modernization-2027-readiness-lethality/",
                    "article_site": "https://defensescoop.com/",
                    "article_date": "2025-04-07",
                    "context": "targets” to accelerate to enhance the Navy’s long-term advantage and ensure readiness for a possible war with China by"
                },
                "target_entity": {
                    "ent_name": "China",
                    "ent_type": "GPE",
                    "ent_uuid": "f1ee5a5d-c44f-41fc-ad38-d59ac69ca848",
                    "ent_aliases": []
                }
            }
        ],
        [
            {
                "source_entity": {
                    "ent_name": "Raytheon",
                    "ent_type": "ORG",
                    "ent_uuid": "b2729e25-3a1d-49ff-88f5-39bd1e9ab9ee",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "Deal",
                    "article_title": "Raytheon awarded $147M Navy contract for modified Coyote drone",
                    "article_url": "https://defensescoop.com/2023/05/26/raytheon-awarded-147m-navy-contract-for-modified-coyote-drone/",
                    "article_site": "https://defensescoop.com/",
                    "article_date": "2023-05-26",
                    "context": "Raytheon is being awarded a cost-plus-fixed-fee contract worth up to $147 million contract to support the Navy’s"
                },
                "target_entity": {
                    "ent_name": "Navy",
                    "ent_type": "ORG",
                    "ent_uuid": "03d4e2ba-84c2-4f24-8513-9f4cf74e20bc",
                    "ent_aliases": []
                }
            },
            {
                "source_entity": {
                    "ent_name": "Navy",
                    "ent_type": "ORG",
                    "ent_uuid": "03d4e2ba-84c2-4f24-8513-9f4cf74e20bc",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "Oppo",
                    "article_title": "How the Navy’s vision to enhance readiness and lethality by 2027 hinges on technology",
                    "article_url": "https://defensescoop.com/2025/04/07/james-kilby-navy-technology-modernization-2027-readiness-lethality/",
                    "article_site": "https://defensescoop.com/",
                    "article_date": "2025-04-07",
                    "context": "targets” to accelerate to enhance the Navy’s long-term advantage and ensure readiness for a possible war with China by"
                },
                "target_entity": {
                    "ent_name": "China",
                    "ent_type": "GPE",
                    "ent_uuid": "f1ee5a5d-c44f-41fc-ad38-d59ac69ca848",
                    "ent_aliases": []
                }
            }
        ],
        [
            {
                "source_entity": {
                    "ent_name": "Raytheon",
                    "ent_type": "ORG",
                    "ent_uuid": "b2729e25-3a1d-49ff-88f5-39bd1e9ab9ee",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "Deal",
                    "article_title": "Raytheon scores engineering and development contract for extended range airborne electronic attack pod",
                    "article_url": "https://defensescoop.com/2024/10/02/raytheon-scores-engineering-and-development-contract-for-extended-range-airborne-electronic-attack-pod/",
                    "article_site": "https://defensescoop.com/",
                    "article_date": "2024-10-02",
                    "context": "The Navy awarded Raytheon"
                },
                "target_entity": {
                    "ent_name": "Navy",
                    "ent_type": "ORG",
                    "ent_uuid": "03d4e2ba-84c2-4f24-8513-9f4cf74e20bc",
                    "ent_aliases": []
                }
            },
            {
                "source_entity": {
                    "ent_name": "Navy",
                    "ent_type": "ORG",
                    "ent_uuid": "03d4e2ba-84c2-4f24-8513-9f4cf74e20bc",
                    "ent_aliases": []
                },
                "connection_data": {
                    "type": "OperatesIn",
                    "article_title": "US applies double standards on nuclear issue: Defense Spokesperson - China Military",
                    "article_url": "http://eng.chinamil.com.cn/VOICES/MinistryofNationalDefense_209794/16348744.html",
                    "article_site": "http://eng.chinamil.com.cn/",
                    "article_date": "undefined-undefined-undefined",
                    "context": "said that China was accelerating and expanding nuclear arsenal of its Army, Navy and Air Force"
                },
                "target_entity": {
                    "ent_name": "China",
                    "ent_type": "GPE",
                    "ent_uuid": "f1ee5a5d-c44f-41fc-ad38-d59ac69ca848",
                    "ent_aliases": []
                }
            }
        ]
    ]
}