{"openapi":"3.1.0","info":{"title":"DataScoop API","version":"1.0.0","summary":"Official public datasets as filtered rows: CSV, JSON and MCP.","description":"Preview any dataset free (25 rows per call, no key). Pro keys return every row. Organisational data only; every response carries the attribution to keep. MCP endpoint: https://datascoop.io/mcp. Machine-readable overview: https://datascoop.io/llms.txt","termsOfService":"https://datascoop.io/terms","contact":{"url":"https://datascoop.io/contact"},"license":{"name":"Data reused under the open licence listed per dataset","url":"https://datascoop.io/licences"}},"servers":[{"url":"https://datascoop.io"}],"externalDocs":{"url":"https://datascoop.io/docs","description":"Docs"},"security":[{},{"bearerAuth":[]},{"apiKeyQuery":[]}],"tags":[{"name":"United Kingdom"},{"name":"United States"},{"name":"Australia"}],"paths":{"/v1/datasets":{"get":{"operationId":"listDatasets","summary":"List datasets","description":"Every dataset with its country, coverage, row count, licence and refresh date.","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","enum":["GB","US","AU"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"datasets":{"type":"array","items":{"$ref":"#/components/schemas/Dataset"}},"countries":{"type":"array","items":{"type":"object"}}}}}}}}}},"/v1/datasets/{id}":{"get":{"operationId":"getDatasetSchema","summary":"Columns and filters of a dataset","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["cqc","fsa","us-food-inspections","us-building-permits","fhis-scotland","charity-commission","companies-house","us-motor-carriers","us-business-licenses","us-liquor-licenses","au-aged-care"]}}],"responses":{"200":{"description":"OK"},"404":{"description":"Unknown dataset"}}}},"/v1/datasets/{id}/query":{"get":{"operationId":"queryDataset","summary":"Query any dataset (generic form)","description":"Filters are query parameters named after the dataset's filter keys (see GET /v1/datasets/{id}). The per-dataset operations below list them explicitly.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","enum":["cqc","fsa","us-food-inspections","us-building-permits","fhis-scotland","charity-commission","companies-house","us-motor-carriers","us-business-licenses","us-liquor-licenses","au-aged-care"]}},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"Unknown dataset"}}}},"/v1/pricing":{"get":{"operationId":"getPricing","summary":"Prices in the caller's currency","parameters":[{"name":"currency","in":"query","required":false,"schema":{"type":"string","enum":["GBP","USD","EUR","CAD","AUD","NZD"]}}],"responses":{"200":{"description":"OK"}}}},"/v1/me":{"get":{"operationId":"getMe","summary":"The calling key's plan and usage","security":[{"bearerAuth":[]},{"apiKeyQuery":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or unknown key"}}}},"/signup":{"post":{"operationId":"signup","summary":"Create a free account and API key","description":"Returns the key once. If the email already has an account, no key is returned; use /login.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"}},"required":["email"]}}}},"responses":{"200":{"description":"Key issued","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"api_key":{"type":"string"},"plan":{"type":"string"}}}}}},"409":{"description":"Account exists"}}}},"/v1/datasets/cqc/query":{"get":{"operationId":"query_cqc","summary":"CQC care providers directory (England)","description":"Every CQC-registered care home, home care agency, GP, dentist and hospital in England by region, council and service type. CSV download, API and MCP. Preview free. 57,080 rows. Licence: Open Government Licence v3.0. Example: Every nursing home in Yorkshire, as CSV: https://datascoop.io/v1/datasets/cqc/query?region=Yorkshire%20and%20The%20Humber&serviceType=Nursing%20homes","tags":["United Kingdom"],"parameters":[{"name":"region","in":"query","required":false,"description":"Region: exact match, case-insensitive.","schema":{"type":"string","enum":["East Midlands","East of England","London","North East","North West","South East","South West","West Midlands","Yorkshire and The Humber"]},"example":"London"},{"name":"localAuthority","in":"query","required":false,"description":"Local authority: substring match, case-insensitive.","schema":{"type":"string"},"example":"Leeds"},{"name":"careHome","in":"query","required":false,"description":"Care homes only: true to apply. Residential and nursing homes only","schema":{"type":"boolean"},"example":true},{"name":"serviceType","in":"query","required":false,"description":"Service type contains: substring match, case-insensitive. e.g. Residential homes, Nursing homes, Homecare agencies, Supported living, Dentist, Doctors/GPs, Hospital, Hospice, Clinic, Ambulances, Diagnosis/screening","schema":{"type":"string"},"example":"Nursing homes"},{"name":"specialism","in":"query","required":false,"description":"Specialism contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Dementia"},{"name":"postcodeArea","in":"query","required":false,"description":"Postcode area: prefix match, case-insensitive.","schema":{"type":"string"},"example":"LS"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Manor"},{"name":"providerContains","in":"query","required":false,"description":"Provider contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Barchester"},{"name":"overallRating","in":"query","required":false,"description":"Overall rating: exact match, case-insensitive. Populated only when the CQC API key is configured; the public directory file carries no ratings.","schema":{"type":"string","enum":["Outstanding","Good","Requires improvement","Inadequate"]},"example":"Inadequate"},{"name":"minBeds","in":"query","required":false,"description":"Minimum beds: minimum (inclusive). Requires the CQC API (beds are not in the directory file).","schema":{"type":"number"},"example":40},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/fsa/query":{"get":{"operationId":"query_fsa","summary":"FSA food hygiene ratings (England, Wales & NI)","description":"FSA food hygiene ratings for every food business by area, rating and type, in your spreadsheet in a minute: CSV download, REST API, or MCP for AI agents. 552,886 rows. Licence: Open Government Licence v3.0. Example: All 1-star takeaways in Leeds, as CSV: https://datascoop.io/v1/datasets/fsa/query?localAuthority=Leeds&rating=1&businessType=Takeaway","tags":["United Kingdom"],"parameters":[{"name":"localAuthority","in":"query","required":false,"description":"Local authority: substring match, case-insensitive. Council name, e.g. Leeds, Camden, Cardiff","schema":{"type":"string"},"example":"Leeds"},{"name":"businessType","in":"query","required":false,"description":"Business type: substring match, case-insensitive. e.g. Restaurant/Cafe/Canteen, Takeaway/sandwich shop, Pub/bar/nightclub, Retailers - supermarkets/hypermarkets, School/college/university","schema":{"type":"string"},"example":"Takeaway"},{"name":"rating","in":"query","required":false,"description":"Hygiene rating: exact match, case-insensitive.","schema":{"type":"string","enum":["5","4","3","2","1","0","AwaitingInspection","Exempt"]},"example":"1"},{"name":"postcodeArea","in":"query","required":false,"description":"Postcode area: prefix match, case-insensitive.","schema":{"type":"string"},"example":"LS1"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Pizza"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/us-food-inspections/query":{"get":{"operationId":"query_us_food_inspections","summary":"US restaurant inspections (NYC, Chicago, New York State, Austin)","description":"Restaurant inspection results and grades for NYC, Chicago, New York State and Austin, in your spreadsheet in a minute: CSV download, REST API, or MCP for agents. 58,898 rows. Licence: Public records, city/state open-data terms. Example: Every failed inspection in Chicago, as CSV: https://datascoop.io/v1/datasets/us-food-inspections/query?source=Chicago&result=Fail","tags":["United States"],"parameters":[{"name":"source","in":"query","required":false,"description":"Source: exact match, case-insensitive. Publishing jurisdiction","schema":{"type":"string","enum":["New York City","Chicago","New York State","Austin"]},"example":"Chicago"},{"name":"result","in":"query","required":false,"description":"Result / grade: exact match, case-insensitive. NYC grades A/B/C; Chicago Pass/Fail/Pass w/ Conditions; Austin Pass/Fail; New York State Critical violations/No critical violations","schema":{"type":"string"},"example":"Fail"},{"name":"facilityType","in":"query","required":false,"description":"Facility type / cuisine: substring match, case-insensitive.","schema":{"type":"string"},"example":"Pizza"},{"name":"city","in":"query","required":false,"description":"City / borough contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Brooklyn"},{"name":"zipPrefix","in":"query","required":false,"description":"ZIP starts with: prefix match, case-insensitive.","schema":{"type":"string"},"example":"606"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Taco"},{"name":"since","in":"query","required":false,"description":"Inspected since (YYYY-MM-DD): minimum (inclusive).","schema":{"type":"string"},"example":"2026-01-01"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/us-building-permits/query":{"get":{"operationId":"query_us_building_permits","summary":"US building permits (NYC, Chicago, Los Angeles, Austin)","description":"Issued building permits for NYC, Chicago, Los Angeles and Austin by area, category, cost and date, in your spreadsheet in a minute: CSV, REST API, or MCP. 92,743 rows. Licence: Public records, city open-data terms. Example: Every new-construction permit in Chicago over $1m, as CSV: https://datascoop.io/v1/datasets/us-building-permits/query?source=Chicago&category=New%20construction&minCost=1000000","tags":["United States"],"parameters":[{"name":"source","in":"query","required":false,"description":"Source: exact match, case-insensitive. Publishing city","schema":{"type":"string","enum":["New York City","Chicago","Los Angeles","Austin"]},"example":"Chicago"},{"name":"category","in":"query","required":false,"description":"Category: exact match, case-insensitive.","schema":{"type":"string","enum":["New construction","Alteration or repair","Demolition","Electrical","Plumbing","Mechanical","Sign","Other"]},"example":"New construction"},{"name":"area","in":"query","required":false,"description":"Area contains: substring match, case-insensitive. Borough, community area or plan area","schema":{"type":"string"},"example":"Brooklyn"},{"name":"zipPrefix","in":"query","required":false,"description":"ZIP starts with: prefix match, case-insensitive.","schema":{"type":"string"},"example":"112"},{"name":"descriptionContains","in":"query","required":false,"description":"Description contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"solar"},{"name":"minCost","in":"query","required":false,"description":"Minimum estimated cost (USD): minimum (inclusive).","schema":{"type":"number"},"example":100000},{"name":"since","in":"query","required":false,"description":"Issued since (YYYY-MM-DD): minimum (inclusive).","schema":{"type":"string"},"example":"2026-06-01"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/fhis-scotland/query":{"get":{"operationId":"query_fhis_scotland","summary":"FSA food hygiene information scheme (Scotland)","description":"Every Scottish food business with its FHIS result (Pass or Improvement Required), by council and type, in your spreadsheet in a minute: CSV, REST API, or MCP. 58,869 rows. Licence: Open Government Licence v3.0. Example: Every Improvement Required result in Glasgow, as CSV: https://datascoop.io/v1/datasets/fhis-scotland/query?localAuthority=Glasgow&rating=Improvement%20Required","tags":["United Kingdom"],"parameters":[{"name":"localAuthority","in":"query","required":false,"description":"Local authority: substring match, case-insensitive. Council name, e.g. Glasgow City, City of Edinburgh, Aberdeen City","schema":{"type":"string"},"example":"Glasgow"},{"name":"businessType","in":"query","required":false,"description":"Business type: substring match, case-insensitive.","schema":{"type":"string"},"example":"Restaurant"},{"name":"rating","in":"query","required":false,"description":"Inspection result: exact match, case-insensitive.","schema":{"type":"string","enum":["Pass","Pass and Eat Safe","Improvement Required","Awaiting Inspection","Exempt"]},"example":"Improvement Required"},{"name":"postcodeArea","in":"query","required":false,"description":"Postcode area: prefix match, case-insensitive.","schema":{"type":"string"},"example":"G1"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Cafe"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/charity-commission/query":{"get":{"operationId":"query_charity_commission","summary":"Charity Commission register (England & Wales)","description":"Every charity on the Charity Commission register for England and Wales by type, income, area and activity. CSV download, REST API, or MCP for AI agents. Preview free. 398,054 rows. Licence: Open Government Licence v3.0. Example: Every registered charity with income over GBP 1m in Leeds postcodes, as CSV: https://datascoop.io/v1/datasets/charity-commission/query?status=Registered&minIncome=1000000&postcodeArea=LS","tags":["United Kingdom"],"parameters":[{"name":"status","in":"query","required":false,"description":"Registration status: exact match, case-insensitive. Most buyers want Registered only","schema":{"type":"string","enum":["Registered","Removed"]},"example":"Registered"},{"name":"charityType","in":"query","required":false,"description":"Charity type: exact match, case-insensitive.","schema":{"type":"string","enum":["CIO","Charitable company","Trust","Previously excepted","Other"]},"example":"CIO"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Hospice"},{"name":"activitiesContains","in":"query","required":false,"description":"Activities contain: substring match, case-insensitive. Search the charity's own description of what it does","schema":{"type":"string"},"example":"food bank"},{"name":"postcodeArea","in":"query","required":false,"description":"Postcode area: prefix match, case-insensitive. Postcode prefix, e.g. LS (Leeds), SW1, M1. A bare letter also matches longer areas (M matches ME and MK), so use the district when it matters","schema":{"type":"string"},"example":"LS"},{"name":"minIncome","in":"query","required":false,"description":"Minimum latest income (GBP): minimum (inclusive).","schema":{"type":"number"},"example":1000000},{"name":"maxIncome","in":"query","required":false,"description":"Maximum latest income (GBP): maximum (inclusive).","schema":{"type":"number"},"example":25000},{"name":"registeredSince","in":"query","required":false,"description":"Registered since (YYYY-MM-DD): minimum (inclusive).","schema":{"type":"string"},"example":"2025-01-01"},{"name":"reportingStatus","in":"query","required":false,"description":"Reporting status: exact match, case-insensitive.","schema":{"type":"string","enum":["Submission Received","Submission Received Late","Submission Overdue","Submission Double Default","New","Suppressed"]},"example":"Submission Overdue"},{"name":"mainCharitiesOnly","in":"query","required":false,"description":"Main charities only (exclude linked): true to apply.","schema":{"type":"boolean"},"example":true},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/companies-house/query":{"get":{"operationId":"query_companies_house","summary":"Companies House register (UK)","description":"Every company on the Companies House register by status, type, town, postcode, SIC code and incorporation date. Download a list for Excel, call the API, or connect your AI agent. 5,695,465 rows. Licence: Crown copyright (Companies House reuse terms). Example: Active companies incorporated in Leeds since 1 January 2026, as CSV: https://datascoop.io/v1/datasets/companies-house/query?status=Active&postTown=Leeds&incorporatedSince=2026-01-01","tags":["United Kingdom"],"parameters":[{"name":"status","in":"query","required":false,"description":"Status: exact match, case-insensitive.","schema":{"type":"string","enum":["Active","Active - Proposal to Strike off","Liquidation","In Administration","Live but Receiver Manager on at least one charge","Voluntary Arrangement","In Administration/Administrative Receiver","RECEIVERSHIP","ADMINISTRATION ORDER","ADMINISTRATIVE RECEIVER"]},"example":"Active"},{"name":"category","in":"query","required":false,"description":"Company type: exact match, case-insensitive.","schema":{"type":"string","enum":["Private Limited Company","PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)","Limited Partnership","Limited Liability Partnership","Community Interest Company","Charitable Incorporated Organisation","PRI/LBG/NSC (Private, Limited by guarantee, no share capital, use of 'Limited' exemption)","Overseas Entity","Other company type","Registered Society","Scottish Charitable Incorporated Organisation","Private Unlimited Company","Public Limited Company","Royal Charter Company","Investment Company with Variable Capital","United Kingdom Economic Interest Grouping","Scottish Partnership","Industrial and Provident Society"]},"example":"Private Limited Company"},{"name":"postTown","in":"query","required":false,"description":"Post town: exact match, case-insensitive. Registered office post town, exact (case-insensitive), e.g. Leeds, Manchester, London","schema":{"type":"string"},"example":"Leeds"},{"name":"postcodeArea","in":"query","required":false,"description":"Postcode area: prefix match, case-insensitive. Registered office postcode prefix, e.g. LS (Leeds), SW1, M1. A bare letter also matches longer areas (M matches ME and MK)","schema":{"type":"string"},"example":"LS1"},{"name":"county","in":"query","required":false,"description":"County contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"West Yorkshire"},{"name":"sic","in":"query","required":false,"description":"SIC code or activity contains: substring match, case-insensitive. Matches any of the four SIC codes or their descriptions, e.g. 62012 or \"software development\"","schema":{"type":"string"},"example":"62012"},{"name":"sicCode","in":"query","required":false,"description":"Primary SIC code starts with: prefix match, case-insensitive. e.g. 62 for computer programming and consultancy, 56 for food and beverage service, 86 for human health","schema":{"type":"string"},"example":"62"},{"name":"incorporatedSince","in":"query","required":false,"description":"Incorporated since (YYYY-MM-DD): minimum (inclusive). New companies are the classic lead list","schema":{"type":"string"},"example":"2026-01-01"},{"name":"incorporatedBefore","in":"query","required":false,"description":"Incorporated before (YYYY-MM-DD): maximum (inclusive).","schema":{"type":"string"},"example":"2000-01-01"},{"name":"accountCategory","in":"query","required":false,"description":"Accounts category: exact match, case-insensitive.","schema":{"type":"string","enum":["MICRO ENTITY","NO ACCOUNTS FILED","TOTAL EXEMPTION FULL","DORMANT","UNAUDITED ABRIDGED","FULL","SMALL","AUDIT EXEMPTION SUBSIDIARY","GROUP","TOTAL EXEMPTION SMALL","MEDIUM","ACCOUNTS TYPE NOT AVAILABLE","AUDITED ABRIDGED","FILING EXEMPTION SUBSIDIARY"]},"example":"MICRO ENTITY"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Consulting"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/us-motor-carriers/query":{"get":{"operationId":"query_us_motor_carriers","summary":"US trucking companies (FMCSA motor carrier census)","description":"Every active FMCSA-registered trucking company by state, city, fleet size and cargo. Download a list for Excel or your CRM, or use the API and MCP. 2,230,993 rows. Licence: US federal public record (FMCSA open data). Example: Texas carriers running 21 to 100 power units, as CSV: https://datascoop.io/v1/datasets/us-motor-carriers/query?state=TX&fleetBand=21-100%20units","tags":["United States"],"parameters":[{"name":"state","in":"query","required":false,"description":"State: exact match, case-insensitive. Physical location state (two letters)","schema":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","PR"]},"example":"TX"},{"name":"city","in":"query","required":false,"description":"City: exact match, case-insensitive. Physical location city, exact (case-insensitive)","schema":{"type":"string"},"example":"Houston"},{"name":"zipPrefix","in":"query","required":false,"description":"ZIP starts with: prefix match, case-insensitive.","schema":{"type":"string"},"example":"770"},{"name":"operation","in":"query","required":false,"description":"Operation: exact match, case-insensitive.","schema":{"type":"string","enum":["Interstate","Intrastate hazmat","Intrastate non-hazmat"]},"example":"Interstate"},{"name":"fleetBand","in":"query","required":false,"description":"Fleet size band: exact match, case-insensitive.","schema":{"type":"string","enum":["1 unit","2-5 units","6-20 units","21-100 units","100+ units"]},"example":"21-100 units"},{"name":"minPowerUnits","in":"query","required":false,"description":"Minimum power units: minimum (inclusive).","schema":{"type":"number"},"example":10},{"name":"maxPowerUnits","in":"query","required":false,"description":"Maximum power units: maximum (inclusive).","schema":{"type":"number"},"example":50},{"name":"minDrivers","in":"query","required":false,"description":"Minimum drivers: minimum (inclusive).","schema":{"type":"number"},"example":5},{"name":"classification","in":"query","required":false,"description":"Classification contains: substring match, case-insensitive. Authorized For Hire, Exempt For Hire, Private (Property), Private (Passenger, Business), U.S. Mail, Federal/State/Local Government, Indian Tribe","schema":{"type":"string"},"example":"Authorized For Hire"},{"name":"businessType","in":"query","required":false,"description":"Business type: exact match, case-insensitive. Populated for about 7% of carriers in the census (mostly older registrations)","schema":{"type":"string","enum":["Corporation","LLC","Sole Proprietor","Partnership","Other"]},"example":"Corporation"},{"name":"cargo","in":"query","required":false,"description":"Cargo contains: substring match, case-insensitive. e.g. General Freight, Household Goods, Building Materials, Fresh Produce, Liquids/Gases, Intermodal Containers, Passengers, Oilfield Equipment, Livestock, Grain, Coal, Meat, Garbage, Chemicals, Dry Bulk, Refrigerated Food, Beverages, Paper Products, Utilities, Farm Supplies, Construction, Water Well, Motor Vehicles, Drive/Tow away, Logs/Poles, Mobile Homes, Machinery, Metal sheets","schema":{"type":"string"},"example":"Refrigerated Food"},{"name":"hazmat","in":"query","required":false,"description":"Hazmat carriers only: true to apply.","schema":{"type":"boolean"},"example":true},{"name":"safetyRating","in":"query","required":false,"description":"Safety rating: exact match, case-insensitive.","schema":{"type":"string","enum":["Satisfactory","Conditional","Unsatisfactory"]},"example":"Conditional"},{"name":"registeredSince","in":"query","required":false,"description":"Registered since (YYYY-MM-DD): minimum (inclusive). New carriers are the classic lead list","schema":{"type":"string"},"example":"2026-01-01"},{"name":"status","in":"query","required":false,"description":"Status: exact match, case-insensitive. The default ingest keeps active carriers only","schema":{"type":"string","enum":["Active","Inactive","Pending"]},"example":"Active"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Logistics"},{"name":"cityState","in":"query","required":false,"description":"City, State: exact match, case-insensitive. Exact city and state as shown on the list pages","schema":{"type":"string"},"example":"Houston, TX"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/us-business-licenses/query":{"get":{"operationId":"query_us_business_licenses","summary":"US business licences (Chicago, New York City, San Francisco, Los Angeles)","description":"Active business licences in Chicago, New York City, San Francisco and Los Angeles by category, area and issue date. Download new licences for Excel or your CRM. 824,024 rows. Licence: Public records, city open-data terms. Example: Business licences issued in Chicago since 1 August 2026, as CSV: https://datascoop.io/v1/datasets/us-business-licenses/query?source=Chicago&issuedSince=2026-08-01","tags":["United States"],"parameters":[{"name":"source","in":"query","required":false,"description":"Source city: exact match, case-insensitive.","schema":{"type":"string","enum":["Chicago","New York City","San Francisco","Los Angeles"]},"example":"Chicago"},{"name":"area","in":"query","required":false,"description":"Area: exact match, case-insensitive. Exact area as shown on the list pages, e.g. Brooklyn, New York City; Mission, San Francisco; Council District 5, Los Angeles","schema":{"type":"string"},"example":"Lincoln Park, Chicago"},{"name":"areaContains","in":"query","required":false,"description":"Area contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Brooklyn"},{"name":"zipPrefix","in":"query","required":false,"description":"ZIP starts with: prefix match, case-insensitive.","schema":{"type":"string"},"example":"606"},{"name":"category","in":"query","required":false,"description":"Category contains: substring match, case-insensitive. e.g. Retail Food Establishment, Tobacco, Home Improvement Contractor, Restaurant, Limited Business License","schema":{"type":"string"},"example":"Retail Food"},{"name":"naicsPrefix","in":"query","required":false,"description":"NAICS starts with: prefix match, case-insensitive. San Francisco and Los Angeles only; 72 = accommodation and food services, 44-45 = retail, 62 = health care","schema":{"type":"string"},"example":"72"},{"name":"issuedSince","in":"query","required":false,"description":"Issued since (YYYY-MM-DD): minimum (inclusive). New licences are the classic lead list","schema":{"type":"string"},"example":"2026-08-01"},{"name":"startedSince","in":"query","required":false,"description":"Started since (YYYY-MM-DD): minimum (inclusive).","schema":{"type":"string"},"example":"2026-01-01"},{"name":"expiresBefore","in":"query","required":false,"description":"Expires before (YYYY-MM-DD): maximum (inclusive).","schema":{"type":"string"},"example":"2026-12-31"},{"name":"status","in":"query","required":false,"description":"Status: exact match, case-insensitive. As published: Active (NYC, SF, LA) or AAI (Chicago: licence issued)","schema":{"type":"string"},"example":"Active"},{"name":"nameContains","in":"query","required":false,"description":"Name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Pizza"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/us-liquor-licenses/query":{"get":{"operationId":"query_us_liquor_licenses","summary":"US liquor licences (New York, Texas, Missouri, Colorado)","description":"Active liquor licences in New York, Texas, Missouri and Colorado by type, county and issue date. Download new licences for Excel or your CRM, or use the API. 158,442 rows. Licence: Public records, state open-data terms. Example: Texas liquor licences issued since 1 July 2026, as CSV: https://datascoop.io/v1/datasets/us-liquor-licenses/query?source=Texas&issuedSince=2026-07-01","tags":["United States"],"parameters":[{"name":"source","in":"query","required":false,"description":"Source state: exact match, case-insensitive.","schema":{"type":"string","enum":["New York","Texas","Missouri","Colorado"]},"example":"Texas"},{"name":"area","in":"query","required":false,"description":"County, State: exact match, case-insensitive. Exact county and state as shown on the list pages","schema":{"type":"string"},"example":"Harris County, TX"},{"name":"county","in":"query","required":false,"description":"County contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Harris"},{"name":"city","in":"query","required":false,"description":"City: exact match, case-insensitive. Exact, case-insensitive","schema":{"type":"string"},"example":"Houston"},{"name":"zipPrefix","in":"query","required":false,"description":"ZIP starts with: prefix match, case-insensitive.","schema":{"type":"string"},"example":"770"},{"name":"licenseType","in":"query","required":false,"description":"Licence type contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Restaurant"},{"name":"issuedSince","in":"query","required":false,"description":"Issued since (YYYY-MM-DD): minimum (inclusive). New liquor licences are the classic lead list for restaurant and bar openings","schema":{"type":"string"},"example":"2026-07-01"},{"name":"expiresBefore","in":"query","required":false,"description":"Expires before (YYYY-MM-DD): maximum (inclusive).","schema":{"type":"string"},"example":"2026-12-31"},{"name":"status","in":"query","required":false,"description":"Status: exact match, case-insensitive.","schema":{"type":"string"},"example":"Active"},{"name":"nameContains","in":"query","required":false,"description":"Licensee or trade name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Grill"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}},"/v1/datasets/au-aged-care/query":{"get":{"operationId":"query_au_aged_care","summary":"Australia aged care services (Aged Care Service List)","description":"Every Australian Government-subsidised aged care service by state, LGA, provider, care type and places. Download the list for Excel or your CRM, or use the API. 5,378 rows. Licence: Creative Commons Attribution 4.0. Example: Residential aged care homes in New South Wales with 60 or more places, as CSV: https://datascoop.io/v1/datasets/au-aged-care/query?state=NSW&careType=Residential&minResidentialPlaces=60","tags":["Australia"],"parameters":[{"name":"state","in":"query","required":false,"description":"State: exact match, case-insensitive.","schema":{"type":"string","enum":["NSW","VIC","QLD","WA","SA","TAS","ACT","NT"]},"example":"NSW"},{"name":"careType","in":"query","required":false,"description":"Care type: substring match, case-insensitive. e.g. Residential, Home Care, Multi-Purpose Service, Transition Care, Short-Term Restorative Care","schema":{"type":"string"},"example":"Residential"},{"name":"organisationType","in":"query","required":false,"description":"Organisation type: exact match, case-insensitive.","schema":{"type":"string","enum":["Charitable","Community Based","Private Incorporated Body","Publicly Listed Company","Religious","State Government","Local Government"]},"example":"Charitable"},{"name":"lga","in":"query","required":false,"description":"Local government area contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Albury"},{"name":"lgaState","in":"query","required":false,"description":"LGA, State: exact match, case-insensitive. Exact LGA and state as shown on the list pages","schema":{"type":"string"},"example":"Albury, NSW"},{"name":"suburb","in":"query","required":false,"description":"Suburb: exact match, case-insensitive. Exact, case-insensitive","schema":{"type":"string"},"example":"Albury"},{"name":"postcodePrefix","in":"query","required":false,"description":"Postcode starts with: prefix match, case-insensitive.","schema":{"type":"string"},"example":"26"},{"name":"minResidentialPlaces","in":"query","required":false,"description":"Minimum residential places: minimum (inclusive).","schema":{"type":"number"},"example":60},{"name":"remoteness","in":"query","required":false,"description":"Remoteness contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Remote"},{"name":"providerContains","in":"query","required":false,"description":"Provider contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Bupa"},{"name":"nameContains","in":"query","required":false,"description":"Service name contains: substring match, case-insensitive.","schema":{"type":"string"},"example":"Lodge"},{"name":"limit","in":"query","required":false,"description":"Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.","schema":{"type":"integer","minimum":0}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (paging).","schema":{"type":"integer","minimum":0}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV opens in Excel and is never paged.","schema":{"type":"string","enum":["json","csv"]}}],"responses":{"200":{"description":"Matching rows","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResult"}},"text/csv":{"schema":{"type":"string"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"DataScoop API key from /signup"},"apiKeyQuery":{"type":"apiKey","in":"query","name":"api_key"}},"schemas":{"Dataset":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"country":{"type":"string"},"region":{"type":["string","null"]},"licence":{"type":"string"},"attribution":{"type":"string"},"row_count":{"type":"integer"},"refreshed_at":{"type":"string","format":"date-time"}}},"QueryResult":{"type":"object","properties":{"dataset":{"type":"string"},"plan":{"type":"string","enum":["free","pro"]},"total":{"type":"integer","description":"Rows matching the filters"},"returned":{"type":"integer"},"offset":{"type":"integer"},"truncated":{"type":"boolean","description":"true when fewer rows than total were returned"},"ignored":{"type":"array","items":{"type":"string"},"description":"Filter keys the dataset does not know"},"columns":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"}}}},"rows":{"type":"array","items":{"type":"object","additionalProperties":true}},"attribution":{"type":"string","description":"Keep this with the data"},"licence":{"type":"string"},"next_step":{"type":"object","description":"Present when the plan capped the result: links and wording for getting every row","properties":{"message":{"type":"string"},"buy_export_url":{"type":"string","format":"uri"},"signup_url":{"type":"string","format":"uri"},"pricing_url":{"type":"string","format":"uri"}}}},"required":["dataset","total","returned","truncated","rows","attribution"]}}}}