Skip to main content
GET
/
typeahead
curl -G "https://api.dataforb2b.ai/typeahead" \
  -H "api_key: YOUR_API_KEY" \
  --data-urlencode "type=skill" \
  --data-urlencode "q=python" \
  --data-urlencode "limit=5"

import requests

resp = requests.get(
    "https://api.dataforb2b.ai/typeahead",
    headers={"api_key": "YOUR_API_KEY"},
    params={"type": "skill", "q": "python", "limit": 5},
)
print(resp.json())

const params = new URLSearchParams({ type: "skill", q: "python", limit: 5 });
const resp = await fetch(`https://api.dataforb2b.ai/typeahead?${params}`, {
  headers: { api_key: "YOUR_API_KEY" },
});
console.log(await resp.json());

{
  "type": "company",
  "count": 2,
  "credits_used": 0.02,
  "results": [
    {
      "value": "Stripe",
      "popularity": null,
      "metadata": {
        "org_id": "org_0lox54iG5IEZSb71mZWLR8z9CVPs8v1Lj8oQ",
        "logo_url": "https://media.licdn.com/dms/image/..."
      }
    },
    {
      "value": "Recko | A Stripe company",
      "popularity": null,
      "metadata": {
        "org_id": "org_0lox54iG5IEZSb71mZWLR8z9CVKfPiCAFeQc",
        "logo_url": null
      }
    }
  ]
}

{
  "type": "skill",
  "count": 3,
  "credits_used": 0.03,
  "results": [
    { "value": "Python",                        "popularity": "100k+",   "metadata": null },
    { "value": "Python (Programming Language)", "popularity": "100k+",   "metadata": null },
    { "value": "Python Scripting",              "popularity": "1k-10k",  "metadata": null }
  ]
}

{
  "type": "city",
  "count": 3,
  "credits_used": 0.03,
  "results": [
    { "value": "London",                "popularity": "100k+",   "metadata": null },
    { "value": "Londonderry",           "popularity": "<1k",     "metadata": null },
    { "value": "London, United Kingdom","popularity": "<1k",     "metadata": null }
  ]
}

{
  "type": "people_industry",
  "count": 1,
  "credits_used": 0.01,
  "results": [
    { "value": "Computer Software", "popularity": "100k+", "metadata": null }
  ]
}

{
  "type": "investor",
  "count": 2,
  "credits_used": 0.02,
  "results": [
    { "value": "y combinator",                "popularity": "1k-10k", "metadata": null },
    { "value": "y combinator continuity fund","popularity": "<1k",    "metadata": null }
  ]
}

​
Overview

A single endpoint that powers autocomplete for every kind of value used in the people and company search filters — companies, industries, categories, locations, schools, job titles, skills, investors, and more. Pass type=<category> to control what is searched. Results come back ordered by popularity, with prefix matches promoted to the top.

​
Query Parameters

​
type
string
required
The category to autocomplete. One of:
  • company — company names (returns org_id, name, logo)
  • people_industry — industries on profiles (capitalized, e.g. “Computer Software”)
  • company_industry — industries on companies (lowercase, e.g. “software development”)
  • category — business categories (lowercase, e.g. “software”, “fintech”)
  • location — full location strings on profiles (e.g. “San Francisco Bay Area”)
  • city — cities on companies
  • region — regions/states on companies
  • school — schools and universities from education history
  • title — job titles
  • skill — profile skills
  • investor — investor names from company funding rounds
​
q
string
required
Search query. Must be 1-100 characters.
​
limit
integer
default:"20"
Max results, between 1 and 20.

​
Pricing

Each returned result costs 0.01 credit, i.e. 0.1 credit per 10 results. Requests that return zero results are free. The amount debited for the call is returned in the response as credits_used.
Typeahead can be made free for your account on a per-company basis. Reach out to [email protected] if you want it enabled for your organization.

​
Response

​
type
string
Echoes back the type parameter.
​
count
integer
Number of results returned.
​
credits_used
float
Credits debited for this request (count × 0.01).
​
results
array
Matching values, ordered with prefix matches first.
curl -G "https://api.dataforb2b.ai/typeahead" \
  -H "api_key: YOUR_API_KEY" \
  --data-urlencode "type=skill" \
  --data-urlencode "q=python" \
  --data-urlencode "limit=5"

import requests

resp = requests.get(
    "https://api.dataforb2b.ai/typeahead",
    headers={"api_key": "YOUR_API_KEY"},
    params={"type": "skill", "q": "python", "limit": 5},
)
print(resp.json())

const params = new URLSearchParams({ type: "skill", q: "python", limit: 5 });
const resp = await fetch(`https://api.dataforb2b.ai/typeahead?${params}`, {
  headers: { api_key: "YOUR_API_KEY" },
});
console.log(await resp.json());

{
  "type": "company",
  "count": 2,
  "credits_used": 0.02,
  "results": [
    {
      "value": "Stripe",
      "popularity": null,
      "metadata": {
        "org_id": "org_0lox54iG5IEZSb71mZWLR8z9CVPs8v1Lj8oQ",
        "logo_url": "https://media.licdn.com/dms/image/..."
      }
    },
    {
      "value": "Recko | A Stripe company",
      "popularity": null,
      "metadata": {
        "org_id": "org_0lox54iG5IEZSb71mZWLR8z9CVKfPiCAFeQc",
        "logo_url": null
      }
    }
  ]
}

{
  "type": "skill",
  "count": 3,
  "credits_used": 0.03,
  "results": [
    { "value": "Python",                        "popularity": "100k+",   "metadata": null },
    { "value": "Python (Programming Language)", "popularity": "100k+",   "metadata": null },
    { "value": "Python Scripting",              "popularity": "1k-10k",  "metadata": null }
  ]
}

{
  "type": "city",
  "count": 3,
  "credits_used": 0.03,
  "results": [
    { "value": "London",                "popularity": "100k+",   "metadata": null },
    { "value": "Londonderry",           "popularity": "<1k",     "metadata": null },
    { "value": "London, United Kingdom","popularity": "<1k",     "metadata": null }
  ]
}

{
  "type": "people_industry",
  "count": 1,
  "credits_used": 0.01,
  "results": [
    { "value": "Computer Software", "popularity": "100k+", "metadata": null }
  ]
}

{
  "type": "investor",
  "count": 2,
  "credits_used": 0.02,
  "results": [
    { "value": "y combinator",                "popularity": "1k-10k", "metadata": null },
    { "value": "y combinator continuity fund","popularity": "<1k",    "metadata": null }
  ]
}