Skip to navigation
Use the APISearch

Search

One ranked search across everything DefDex tracks.

GET /api/v1/search finds companies, agencies, offices, investors, research labs, programs, technologies and systems. Each hit has an id to pass to /entities/{id}.

curl --get 'https://app.defdex.io/api/v1/search' \
  --header "Authorization: Bearer $DEFDEX_API_KEY" \
  --data-urlencode 'q=anduril'

Parameters

ParameterMeaning
qText to match against names and aliases
typeComma list of company, agency, office, investor, research_lab, other, program, technology, system
parentAn organization id or slug. Returns everything under it, for example org:us-navy
technologyA technology id or slug. Returns organizations and systems linked to it
countryTwo-letter country code
stateState or region
limit1 to 100 per page
cursorThe next_cursor from the previous page

Send q or at least one filter.

Response

{
  "data": [
    {
      "id": "program:f-35-lightning-ii",
      "type": "program",
      "name": "F-35 Lightning II",
      "summary": "…",
      "country": "US",
      "url": "https://defdex.io/programs/f-35-lightning-ii"
    }
  ],
  "next_cursor": "…",
  "build_id": "…"
}

Ids use a prefix: org:anduril-industries, program:f-35-lightning-ii, technology:uncrewed-systems, system:anduril-ghost. Search matches names and aliases, not identity. Confirm a match by name, website and identifiers.

Examples

# Everything under the Navy that is a company
curl --get 'https://app.defdex.io/api/v1/search' -H "Authorization: Bearer $DEFDEX_API_KEY" \
  --data-urlencode 'parent=org:us-navy' --data-urlencode 'type=company'
# Companies working on uncrewed systems
curl --get 'https://app.defdex.io/api/v1/search' -H "Authorization: Bearer $DEFDEX_API_KEY" \
  --data-urlencode 'technology=technology:uncrewed-systems' --data-urlencode 'type=company'

Cost and limits

A search page costs 1 credit. A page returns up to 100 results and a query returns at most 1,000 results. Past that, the response has truncated: true and a bulk object:

{ "truncated": true, "bulk": { "email": "hello@defdex.io", "contact_url": "https://defdex.io/contact" } }

Narrow the filters, or email hello@defdex.io for a bulk dataset. A 409 means a new data build was published while you paged: restart from the first page.