Company data from official sources: new US businesses, registers, tech stack, open jobs, SEC.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Search the Apple App Store, look apps up by id or bundle id, read customer reviews, or get the top free, paid and grossing charts, per country. Returns name, developer, price, rating, rating count, version, genres and the App Store link.
lookup and reviews: App Store ids (or apps.apple.com links), up to 50 for lookup, comma separated
search, lookup, reviews or top_charts. Defaults to search when term is given, lookup when ids or bundle_id is given, top_charts when chart is given
reviews: page of 50 reviews, 1 to 10 (default 1)
search mode: keywords
top_charts: top-free (default), top-paid or top-grossing
Two letter App Store storefront code (default us)
top_charts: all (default) or a category such as games, finance, productivity, health-and-fitness
lookup and reviews: bundle ids such as net.whatsapp.WhatsApp, up to 5 for lookup
How many results, 1 to 50 (search 10, charts 25, reviews 50 by default)
reviews: mostrecent (default) or mosthelpful
true to add the description and release notes to app records
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http company-data https://companyfacts.dev/mcp/
Search the Apple App Store, look apps up by id or bundle id, read customer reviews, or get the top free, paid and grossing charts, per country. Returns name, developer, price, rating, rating count, version, genres and the App Store link.
| Argument | Type | Description |
|---|---|---|
| ids | string | lookup and reviews: App Store ids (or apps.apple.com links), up to 50 for lookup, comma separated |
| mode | string | search, lookup, reviews or top_charts. Defaults to search when term is given, lookup when ids or bundle_id is given, top_charts when chart is given |
| page | string | reviews: page of 50 reviews, 1 to 10 (default 1) |
| term | string | search mode: keywords |
| chart | string | top_charts: top-free (default), top-paid or top-grossing |
| country | string | Two letter App Store storefront code (default us) |
| category | string | top_charts: all (default) or a category such as games, finance, productivity, health-and-fitness |
| bundle_id | string | lookup and reviews: bundle ids such as net.whatsapp.WhatsApp, up to 5 for lookup |
| max_results | string | How many results, 1 to 50 (search 10, charts 25, reviews 50 by default) |
| review_sort | string | reviews: mostrecent (default) or mosthelpful |
| include_description | string | true to add the description and release notes to app records |
{
"type": "object",
"required": [],
"properties": {
"ids": {
"type": "string",
"description": "lookup and reviews: App Store ids (or apps.apple.com links), up to 50 for lookup, comma separated"
},
"mode": {
"type": "string",
"description": "search, lookup, reviews or top_charts. Defaults to search when term is given, lookup when ids or bundle_id is given, top_charts when chart is given"
},
"page": {
"type": "string",
"description": "reviews: page of 50 reviews, 1 to 10 (default 1)"
},
"term": {
"type": "string",
"description": "search mode: keywords"
},
"chart": {
"type": "string",
"description": "top_charts: top-free (default), top-paid or top-grossing"
},
"country": {
"type": "string",
"description": "Two letter App Store storefront code (default us)"
},
"category": {
"type": "string",
"description": "top_charts: all (default) or a category such as games, finance, productivity, health-and-fitness"
},
"bundle_id": {
"type": "string",
"description": "lookup and reviews: bundle ids such as net.whatsapp.WhatsApp, up to 5 for lookup"
},
"max_results": {
"type": "string",
"description": "How many results, 1 to 50 (search 10, charts 25, reviews 50 by default)"
},
"review_sort": {
"type": "string",
"description": "reviews: mostrecent (default) or mosthelpful"
},
"include_description": {
"type": "string",
"description": "true to add the description and release notes to app records"
}
}
}Is this address worth sending to: syntax, whether the domain exists and has mail servers, and whether it is a throwaway, role (info@, sales@) or free-provider address. It never contacts the mailbox, so a missing mailbox at a real domain still passes, and the answer says so.
| Argument | Type | Description |
|---|---|---|
| email* | string | One email address. |
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "One email address."
}
}
}One company in one call, from its domain: registrar, DNS and email provider, the website's tech stack, and hiring from its own job board (open roles by department and place, salary ranges, roles opened or closed lately). Add name and country for the official register entry, or ticker for SEC figures. Each part links to its source; a part with nothing to report says why.
| Argument | Type | Description |
|---|---|---|
| name | string | Company name. Improves the hiring match, and with country adds the official register entry. |
| domain* | string | The company's website domain, URL or an email address at it. |
| ticker | string | Stock ticker or SEC CIK, to add reported revenue from SEC filings. |
| country | string | Register for the name: gb, no, fr, fi, cz, sk, ie, au, or global (LEI). Needs name. |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"name": {
"type": "string",
"description": "Company name. Improves the hiring match, and with country adds the official register entry."
},
"domain": {
"type": "string",
"description": "The company's website domain, URL or an email address at it."
},
"ticker": {
"type": "string",
"description": "Stock ticker or SEC CIK, to add reported revenue from SEC filings."
},
"country": {
"type": "string",
"description": "Register for the name: gb, no, fr, fi, cz, sk, ie, au, or global (LEI). Needs name."
}
}
}Finds companies across everything we track: newly formed New York, Colorado, Oregon, Connecticut and Pennsylvania businesses with a website found with proof. Filter by state, city, name, formation date, technology on their site (for example Shopify or WordPress), whether they publish a phone, role inbox or contact page, and hiring. Returns register details, website, technologies and job board, newest first. No match is never charged.
| Argument | Type | Description |
|---|---|---|
| has | string | Keep companies whose site publishes these: any of phone, role_email, contact_page. |
| city | string | City as the register gives it, not case sensitive. |
| name | string | Part of the legal name. |
| tech | string | Technology names on the home page, comma separated; all must be present. |
| limit | integer | Companies per page, 1 to 100. Default 25. |
| state | string | Any of NY, CO, OR, CT, PA, comma separated. |
| hiring | string | true for companies with open roles on a job board we read, false for none. |
| offset | integer |
Open jobs across several companies at once, in one schema. This is the thing no single applicant-tracking system can do: each vendor only knows about its own customers. Companies on different systems come back with the same field names. One company failing does not lose the others.
| Argument | Type | Description |
|---|---|---|
| companies* | array | Up to 20 company board names or careers URLs. |
| per_company | integer | Maximum postings per company. |
{
"type": "object",
"required": [
"companies"
],
"properties": {
"companies": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"description": "Up to 20 company board names or careers URLs."
},
"per_company": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Maximum postings per company."
}
}
}Fetch one web page and report the technologies behind it (CMS, ecommerce platform, analytics, CDN, web server, frameworks, payment processors, email provider) with a confidence and the evidence for each. Reads HTML, headers, cookies and DNS from one page load; it cannot see what only a running browser reveals.
| Argument | Type | Description |
|---|---|---|
| url* | string | A domain or a full web address to analyze. |
| min_confidence | string | Hide detections below this confidence, 0 to 100. Default 50. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "A domain or a full web address to analyze."
},
"min_confidence": {
"type": "string",
"description": "Hide detections below this confidence, 0 to 100. Default 50."
}
}
}For one domain: whether it is registered, its registrar, created, updated and expiry dates, status codes and nameservers (from the registry's RDAP server), plus its A, AAAA, MX, NS and TXT records, the email provider behind its MX, and whether it publishes SPF and DMARC. No registrant names or contact details are returned.
| Argument | Type | Description |
|---|---|---|
| domain* | string | A domain, URL or email address; the registered domain is used. |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "A domain, URL or email address; the registered domain is used."
}
}
}Read a web page and return the named fields as JSON, using only what the page states; a value the page does not give comes back empty rather than guessed. Name fields, or pass a JSON Schema, or neither for a title, summary and key points. Needs an API key (5 calls from its balance); a failed extraction is refunded.
| Argument | Type | Description |
|---|---|---|
| url* | string | Full address, starting http:// or https://. |
| fields | array | Field names to fill, e.g. ['price', 'founded', 'ceo']. Letters, digits and underscores. |
| schema | object | A JSON Schema with type 'object', instead of fields. |
| instructions | string | Optional guidance, up to 500 characters. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Full address, starting http:// or https://."
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 25,
"description": "Field names to fill, e.g. ['price', 'founded', 'ceo']. Letters, digits and underscores."
},
"schema": {
"type": "object",
"description": "A JSON Schema with type 'object', instead of fields."
},
"instructions": {
"type": "string",
"description": "Optional guidance, up to 500 characters."
}
}
}Searches awarded US federal contracts on USAspending.gov by agency, keyword and dollar amount, largest first. Recompete mode instead lists contracts expiring soonest within a window (set min_amount to keep the search narrow), with the incumbent and days until expiry. Every record links to the official award page.
| Argument | Type | Description |
|---|---|---|
| mode | string | search lists awards, largest first; recompete lists contracts about to expire, soonest first. Defaults to recompete when an expiring_ field is set. |
| limit | string | Awards to return, 1 to 100. Default 25. |
| agency | string | Awarding top-tier agency name. Several names separated by a semicolon. |
| keyword | string | Free text across award descriptions and recipient names. Up to 500 characters. |
| end_date | string | YYYY-MM-DD. Default today. |
| min_amount | string | Only awards at or above this many dollars. Recompete mode usually needs this, or an agency or keyword, to be narrow enough. |
| start_date | string | YYYY-MM-DD, awards with activity from this date. Default 2024-10-01 (the past year in recompete mode). Not before 2007-10-01. |
Find which applicant-tracking system a company's careers page runs on. Greenhouse, Ashby, Lever and Workable all publish open job board APIs, and all of them are unusable unless you already know the company's board name. None publishes a directory of its customers, and none could, since no vendor knows about the others. Use this first when you have a company name rather than a careers URL.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum matches to return. |
| company* | string | Company name or board name, for example 'anthropic' or '1Password'. Case and punctuation do not matter. |
{
"type": "object",
"required": [
"company"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Maximum matches to return."
},
"company": {
"type": "string",
"description": "Company name or board name, for example 'anthropic' or '1Password'. Case and punctuation do not matter."
}
}
}One company's hiring at a glance: open roles counted by department and by location, remote share, salary ranges per currency where the job board publishes pay, and which roles opened or closed in the last 7 or 30 days from a daily record of every board. Reads the company's live Greenhouse, Ashby, Lever or Workable board. Give a company name, board name or careers URL.
| Argument | Type | Description |
|---|---|---|
| days | string | Change window: 7 or 30 days. Default 30. |
| company* | string | Company or board name (e.g. stripe), or a careers URL on Greenhouse, Ashby, Lever or Workable. |
{
"type": "object",
"required": [
"company"
],
"properties": {
"days": {
"type": "string",
"description": "Change window: 7 or 30 days. Default 30."
},
"company": {
"type": "string",
"description": "Company or board name (e.g. stripe), or a careers URL on Greenhouse, Ashby, Lever or Workable."
}
}
}What changed in hiring, day by day: jobs newly posted, taken down, reopened, or edited (title, location or salary), read daily from every job board in the directory. Call it each day with since set to the last day you saw, rather than re-reading every board. Omit companies for the whole market, or filter by kind and title words.
| Argument | Type | Description |
|---|---|---|
| q | string | Only jobs whose title contains this, e.g. 'engineer'. |
| kinds | array | Only these kinds of change. |
| limit | integer | Maximum changes to return. |
| since | string | First day, YYYY-MM-DD. Default: the latest published day. |
| until | string | Last day, YYYY-MM-DD. Default: the latest published day. |
| offset | integer | Skip this many, to page through a long day. |
| companies | array | Company or board names. Omit for every company in the directory. |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Only jobs whose title contains this, e.g. 'engineer'."
},
"kinds": {
"type": "array",
"items": {
"enum": [
"new",
"removed",
"reopened",
"changed",
"board_gone"
],
"type": "string"
},
"description": "Only these kinds of change."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Maximum changes to return."
},
"since": {
"type": "string",
"description": "First day, YYYY-MM-DD. Default: the latest published day."
},
"until": {
"type": "string",
"description": "Last day, YYYY-MM-DD. Default: the latest published day."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Skip this many, to page through a long day."
},
"companies": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Company or board names. Omit for every company in the directory."
}
}
}Every open job at one company, read from its own careers system. Returns title, department, location, employment type, workplace type, posted date, a parsed salary range where the employer publishes one, and a verify_url pointing at the employer's own advert. Salaries are refused rather than guessed: an hourly rate, an ambiguous currency, or bands in two currencies all yield no figure, and salary_text keeps whatever the employer wrote.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum postings to return. |
| company* | string | A board name ('stripe'), a careers URL ('https://jobs.ashbyhq.com/ramp'), or system:name ('ashby:ramp'). |
| include_description | boolean | Include the full job description. Off by default because descriptions are long; contact details are removed either way. |
{
"type": "object",
"required": [
"company"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Maximum postings to return."
},
"company": {
"type": "string",
"description": "A board name ('stripe'), a careers URL ('https://jobs.ashbyhq.com/ramp'), or system:name ('ashby:ramp')."
},
"include_description": {
"type": "boolean",
"default": false,
"description": "Include the full job description. Off by default because descriptions are long; contact details are removed either way."
}
}
}Searches the official Secretary of State business registers of New York, Colorado, Oregon, Connecticut and Pennsylvania, in one record format. mode new is a feed of entities formed in a date window, newest first: use it for new-business leads (LLCs and corporations that just registered) and prospecting. mode search finds entities by legal name and mode lookup by the state's own entity number: use them for KYB (know your business) checks on a supplier or counterparty, to confirm it exists, its type, status (active, delinquent, inactive) and formation date. Every record links to the state's own data row. Never returns officers, directors, individual registered agents, emails, phones or street addresses: business city, state and ZIP only. Each record carries the company's website when one was found with proof (its own pages show the exact legal name and the same city or state), else 'no website found'. New York, Oregon and Pennsylvania publish active entities only, so a missing entity there may be inactive or unregistered. Pennsylvania publishes monthly, so its newest entities are weeks old. If one state fails the others still return and the failure is listed in missing.
| Argument | Type | Description |
|---|---|---|
| mode | string | new lists entities formed between since and until, newest first (the default). search finds entities whose legal name contains name. lookup fetches entities by entity_numbers. |
| name | string | Part of a legal business name, not case sensitive. Required for mode search; in mode new it narrows the feed. |
| limit | integer | Most entities to return across all states, newest first, 1 to 200. Default 50. |
| since | string |
Any public web page or PDF as clean markdown, with its title and final URL after redirects. Some sites refuse automated readers; those calls fail with the reason and cost nothing.
| Argument | Type | Description |
|---|---|---|
| url* | string | Full address, starting http:// or https://. |
| max_chars | integer | Cut the markdown at this length; truncated says whether it was cut. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Full address, starting http:// or https://."
},
"max_chars": {
"type": "integer",
"default": 20000,
"maximum": 200000,
"minimum": 500,
"description": "Cut the markdown at this length; truncated says whether it was cut."
}
}
}Searches one country's official company register by name and returns registered companies in one consistent shape: number, legal name, status, legal form, dates, town and postcode, and a link to the register entry. Covers GB, NO, FR, FI, CZ, SK, IE, AU and the worldwide LEI register. Companies only, no directors or contact details.
| Argument | Type | Description |
|---|---|---|
| name* | string | Company name to search for. |
| limit | string | Most companies to return, 1 to 100. Default 20. |
| country* | string | Register to search: gb, no, fr, fi, cz, sk, ie, au, or global for the LEI register. |
{
"type": "object",
"required": [
"name",
"country"
],
"properties": {
"name": {
"type": "string",
"description": "Company name to search for."
},
"limit": {
"type": "string",
"description": "Most companies to return, 1 to 100. Default 20."
},
"country": {
"type": "string",
"description": "Register to search: gb, no, fr, fi, cz, sk, ie, au, or global for the LEI register."
}
}
}Search Hacker News stories and comments with date, points and comment-count filters, read the live front page and the top, best, new, ask and show lists in rank order, or read whole comment threads. Every item links back to news.ycombinator.com.
| Argument | Type | Description |
|---|---|---|
| mode | string | search (default), front_page, top, best, new, ask, show or story_comments |
| query | string | search mode: keywords. Empty matches everything the filters allow |
| date_to | string | Only items up to the end of this day (UTC), YYYY-MM-DD |
| sort_by | string | search mode: relevance (default) or date (newest first) |
| date_from | string | Only items from this day on (UTC), YYYY-MM-DD |
| max_items | string | How many items, 1 to 50 (default 20; 50 for story_comments; front_page stops at 30) |
| search_in | string | search mode: all (default), title, url or text |
| story_ids | string | story_comments mode: up to 5 item ids or news.ycombinator.com links, separated by commas |
Search the OpenAlex catalogue of scholarly papers by keyword, look papers up by DOI, list the papers that cite one work, or list a university's or journal's papers. Returns title, authors, year, citation count, DOI, abstract and a free full-text link when one exists.
| Argument | Type | Description |
|---|---|---|
| dois | string | doi mode: up to 25 DOIs or OpenAlex ids, separated by commas |
| mode | string | search (default when query is given), doi (default when dois is given), cited_by, institution or source |
| sort | string | relevance (needs query), citations, newest or oldest |
| query | string | Keywords, for example graph neural networks. Double quotes match a phrase. Required for search; narrows institution and source results |
| source | string | source mode: a journal name, an ISSN or an OpenAlex id |
| to_year | string | Only papers published this year or earlier |
| from_year | string | Only papers published this year or later |
| cited_work | string | cited_by mode: a DOI or OpenAlex id; returns the papers that cite it |
Reads US public company financials from SEC EDGAR XBRL. Company mode returns one company's reported history of a metric (revenue, net income, assets and 20 more, or any us-gaap tag) by ticker or CIK. Screen mode ranks every filer on one metric for one calendar period. Every figure carries period_type and a link to its filing. Reports figures, not advice.
| Argument | Type | Description |
|---|---|---|
| mode | string | screen ranks all companies for one period; company gives one company's history. Defaults to company when company is set, else screen. |
| limit | string | Records to return, 1 to 100. Default 50. |
| order | string | desc by default: largest value first in screen mode, newest period first in company mode. |
| metric | string | A name such as revenue, net_income, gross_profit, operating_income, rd_expense, sga_expense, interest_expense, income_tax, or a raw us-gaap tag like Revenues. Default revenue. |
| period | string | Screen mode: CY2023 or CY2023Q1 (calendar year, optional quarter). Default CY2024. |
| company | string | Company mode: ticker or CIK number. |
| max_value | string | Highest value to keep. |
Checks one VAT number against the European Commission's VIES service and returns whether it is a live registration and, where the member state shares it, the registered name. Covers the 27 EU states and Northern Ireland (XI). A busy or down member state is reported as an error, never as an invalid number.
| Argument | Type | Description |
|---|---|---|
| vat* | string | VAT number starting with its two-letter country code. Spaces, dots and hyphens are ignored; GR is read as EL. |
{
"type": "object",
"required": [
"vat"
],
"properties": {
"vat": {
"type": "string",
"description": "VAT number starting with its two-letter country code. Spaces, dots and hyphens are ignored; GR is read as EL."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Oct 31, 2026.
| Skip this many, for the next page. |
| formed_since | string | Formed on or after, YYYY-MM-DD. |
| formed_until | string | Formed on or before, YYYY-MM-DD. |
{
"type": "object",
"required": [],
"properties": {
"has": {
"type": "string",
"description": "Keep companies whose site publishes these: any of phone, role_email, contact_page."
},
"city": {
"type": "string",
"description": "City as the register gives it, not case sensitive."
},
"name": {
"type": "string",
"description": "Part of the legal name."
},
"tech": {
"type": "string",
"description": "Technology names on the home page, comma separated; all must be present."
},
"limit": {
"type": "integer",
"description": "Companies per page, 1 to 100. Default 25."
},
"state": {
"type": "string",
"description": "Any of NY, CO, OR, CT, PA, comma separated."
},
"hiring": {
"type": "string",
"description": "true for companies with open roles on a job board we read, false for none."
},
"offset": {
"type": "integer",
"description": "Skip this many, for the next page."
},
"formed_since": {
"type": "string",
"description": "Formed on or after, YYYY-MM-DD."
},
"formed_until": {
"type": "string",
"description": "Formed on or before, YYYY-MM-DD."
}
}
}| award_types | string | Codes separated by commas, from one group (contracts A,B,C,D by default; 02 to 11 are grants and loans). |
| expiring_after_days | string | Recompete mode: skip contracts ending sooner than this, for bid lead time. Default 0. |
| expiring_within_days | string | Recompete mode: contracts ending within this many days, 1 to 1825. Default 365. |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"search",
"recompete"
],
"type": "string",
"description": "search lists awards, largest first; recompete lists contracts about to expire, soonest first. Defaults to recompete when an expiring_ field is set."
},
"limit": {
"type": "string",
"description": "Awards to return, 1 to 100. Default 25."
},
"agency": {
"type": "string",
"description": "Awarding top-tier agency name. Several names separated by a semicolon."
},
"keyword": {
"type": "string",
"description": "Free text across award descriptions and recipient names. Up to 500 characters."
},
"end_date": {
"type": "string",
"description": "YYYY-MM-DD. Default today."
},
"min_amount": {
"type": "string",
"description": "Only awards at or above this many dollars. Recompete mode usually needs this, or an agency or keyword, to be narrow enough."
},
"start_date": {
"type": "string",
"description": "YYYY-MM-DD, awards with activity from this date. Default 2024-10-01 (the past year in recompete mode). Not before 2007-10-01."
},
"award_types": {
"type": "string",
"description": "Codes separated by commas, from one group (contracts A,B,C,D by default; 02 to 11 are grants and loans)."
},
"expiring_after_days": {
"type": "string",
"description": "Recompete mode: skip contracts ending sooner than this, for bid lead time. Default 0."
},
"expiring_within_days": {
"type": "string",
"description": "Recompete mode: contracts ending within this many days, 1 to 1825. Default 365."
}
}
}| Earliest formation date, YYYY-MM-DD. In mode new it defaults to 7 days ago. In other modes it applies only when given. |
| until | string | Latest formation date, YYYY-MM-DD, inclusive. In mode new it defaults to today. |
| states | string | Registers to read: any of NY, CO, OR, CT, PA, comma separated (an array also works). Default all five. |
| status | string | Keep only active, active_or_delinquent or inactive entities. Default any. New York, Oregon and Pennsylvania are skipped for inactive. |
| entity_type | string | Keep only one kind of entity: llc, corporation (for profit), nonprofit or partnership. Default any. |
| entity_numbers | string | The state's own entity numbers, digits only, comma separated, up to 200. Required for mode lookup. Numbers are not unique across states, so pick the state too. |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"new",
"search",
"lookup"
],
"type": "string",
"description": "new lists entities formed between since and until, newest first (the default). search finds entities whose legal name contains name. lookup fetches entities by entity_numbers."
},
"name": {
"type": "string",
"description": "Part of a legal business name, not case sensitive. Required for mode search; in mode new it narrows the feed."
},
"limit": {
"type": "integer",
"description": "Most entities to return across all states, newest first, 1 to 200. Default 50."
},
"since": {
"type": "string",
"description": "Earliest formation date, YYYY-MM-DD. In mode new it defaults to 7 days ago. In other modes it applies only when given."
},
"until": {
"type": "string",
"description": "Latest formation date, YYYY-MM-DD, inclusive. In mode new it defaults to today."
},
"states": {
"type": "string",
"description": "Registers to read: any of NY, CO, OR, CT, PA, comma separated (an array also works). Default all five."
},
"status": {
"enum": [
"any",
"active",
"active_or_delinquent",
"inactive"
],
"type": "string",
"description": "Keep only active, active_or_delinquent or inactive entities. Default any. New York, Oregon and Pennsylvania are skipped for inactive."
},
"entity_type": {
"enum": [
"any",
"llc",
"corporation",
"nonprofit",
"partnership"
],
"type": "string",
"description": "Keep only one kind of entity: llc, corporation (for profit), nonprofit or partnership. Default any."
},
"entity_numbers": {
"type": "string",
"description": "The state's own entity numbers, digits only, comma separated, up to 200. Required for mode lookup. Numbers are not unique across states, so pick the state too."
}
}
}| story_tag | string | any (default), show_hn, ask_hn or poll |
| min_points | string | Stories with at least this many points |
| content_type | string | search mode: stories (default), comments or both |
| min_comments | string | Stories with at least this many comments |
| include_story | string | story_comments mode: false to leave the story itself out (default true) |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"type": "string",
"description": "search (default), front_page, top, best, new, ask, show or story_comments"
},
"query": {
"type": "string",
"description": "search mode: keywords. Empty matches everything the filters allow"
},
"date_to": {
"type": "string",
"description": "Only items up to the end of this day (UTC), YYYY-MM-DD"
},
"sort_by": {
"type": "string",
"description": "search mode: relevance (default) or date (newest first)"
},
"date_from": {
"type": "string",
"description": "Only items from this day on (UTC), YYYY-MM-DD"
},
"max_items": {
"type": "string",
"description": "How many items, 1 to 50 (default 20; 50 for story_comments; front_page stops at 30)"
},
"search_in": {
"type": "string",
"description": "search mode: all (default), title, url or text"
},
"story_ids": {
"type": "string",
"description": "story_comments mode: up to 5 item ids or news.ycombinator.com links, separated by commas"
},
"story_tag": {
"type": "string",
"description": "any (default), show_hn, ask_hn or poll"
},
"min_points": {
"type": "string",
"description": "Stories with at least this many points"
},
"content_type": {
"type": "string",
"description": "search mode: stories (default), comments or both"
},
"min_comments": {
"type": "string",
"description": "Stories with at least this many comments"
},
"include_story": {
"type": "string",
"description": "story_comments mode: false to leave the story itself out (default true)"
}
}
}| work_types | string | Comma separated: article, preprint, review, book, book-chapter, dissertation, dataset, report, letter, editorial, standard, other |
| institution | string | institution mode: a name, a ROR id or an OpenAlex id; the best name match is used and echoed in matched_entity |
| max_results | string | How many papers, 1 to 50 (default 10) |
| search_scope | string | title_and_abstract (default) or full_text |
| min_citations | string | Only papers cited at least this many times |
| include_abstract | string | false to leave abstracts out (default true) |
| open_access_only | string | true to keep only papers with a free full text |
| exclude_retracted | string | true to drop retracted papers |
{
"type": "object",
"required": [],
"properties": {
"dois": {
"type": "string",
"description": "doi mode: up to 25 DOIs or OpenAlex ids, separated by commas"
},
"mode": {
"type": "string",
"description": "search (default when query is given), doi (default when dois is given), cited_by, institution or source"
},
"sort": {
"type": "string",
"description": "relevance (needs query), citations, newest or oldest"
},
"query": {
"type": "string",
"description": "Keywords, for example graph neural networks. Double quotes match a phrase. Required for search; narrows institution and source results"
},
"source": {
"type": "string",
"description": "source mode: a journal name, an ISSN or an OpenAlex id"
},
"to_year": {
"type": "string",
"description": "Only papers published this year or earlier"
},
"from_year": {
"type": "string",
"description": "Only papers published this year or later"
},
"cited_work": {
"type": "string",
"description": "cited_by mode: a DOI or OpenAlex id; returns the papers that cite it"
},
"work_types": {
"type": "string",
"description": "Comma separated: article, preprint, review, book, book-chapter, dissertation, dataset, report, letter, editorial, standard, other"
},
"institution": {
"type": "string",
"description": "institution mode: a name, a ROR id or an OpenAlex id; the best name match is used and echoed in matched_entity"
},
"max_results": {
"type": "string",
"description": "How many papers, 1 to 50 (default 10)"
},
"search_scope": {
"type": "string",
"description": "title_and_abstract (default) or full_text"
},
"min_citations": {
"type": "string",
"description": "Only papers cited at least this many times"
},
"include_abstract": {
"type": "string",
"description": "false to leave abstracts out (default true)"
},
"open_access_only": {
"type": "string",
"description": "true to keep only papers with a free full text"
},
"exclude_retracted": {
"type": "string",
"description": "true to drop retracted papers"
}
}
}| min_value |
| string |
| Lowest value to keep. Negatives are legal. |
| period_type | string | Keep only quarterly, half_year, nine_month, annual or instant figures. Default any. |
{
"type": "object",
"required": [],
"properties": {
"mode": {
"enum": [
"screen",
"company"
],
"type": "string",
"description": "screen ranks all companies for one period; company gives one company's history. Defaults to company when company is set, else screen."
},
"limit": {
"type": "string",
"description": "Records to return, 1 to 100. Default 50."
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "desc by default: largest value first in screen mode, newest period first in company mode."
},
"metric": {
"type": "string",
"description": "A name such as revenue, net_income, gross_profit, operating_income, rd_expense, sga_expense, interest_expense, income_tax, or a raw us-gaap tag like Revenues. Default revenue."
},
"period": {
"type": "string",
"description": "Screen mode: CY2023 or CY2023Q1 (calendar year, optional quarter). Default CY2024."
},
"company": {
"type": "string",
"description": "Company mode: ticker or CIK number."
},
"max_value": {
"type": "string",
"description": "Highest value to keep."
},
"min_value": {
"type": "string",
"description": "Lowest value to keep. Negatives are legal."
},
"period_type": {
"enum": [
"any",
"quarterly",
"half_year",
"nine_month",
"annual",
"instant"
],
"type": "string",
"description": "Keep only quarterly, half_year, nine_month, annual or instant figures. Default any."
}
}
}