# Kaggle API: Search datasets > Finds public Kaggle datasets on a topic, with size, file formats, usability, popularity and license. Lists at most 100 results in Kaggle's order; files are not downloaded. Unofficial. Not affiliated with or endorsed by Kaggle. - Page: https://fous.com/methods/kaggle.com/search-datasets - Method: `kaggle.com/search_datasets`, version 1 - Website: kaggle.com - Returns: title, owner, size, file types, usability, votes, downloads, last updated, license, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"recently_updated"` | How Kaggle orders the results, for example most_votes. One of "hottest", "most_votes", "newest", "recently_updated", "most_usable". Default "hottest". | | `query` | string | yes | `"house prices"` | Topic to search for, for example house prices. | | `file_type` | string | no | `"csv"` | Only include datasets of this file format, for example csv. One of "any", "csv", "json", "sqlite", "bigquery", "parquet". Default "any". | | `max_results` | integer | no | `25` | Maximum number of datasets to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "recently_updated", "query": "house prices", "file_type": "csv", "max_results": 25 } ``` Its output: ```json { "datasets": [ { "owner": "Thomas Gaehtgens", "title": "Real Estate Listings in Portugal", "votes": 37, "license": "MIT", "size_mb": 4.553, "downloads": 3066, "file_types": [ "CSV" ], "dataset_link": "https://www.kaggle.com/datasets/luvathoms/portugal-real-estate-2024", "usability_score": 10, "last_updated_date": "2026-09-29" }, { "owner": "smartoddstenis", "title": "Tennis Closing Odds: Pinnacle vs 1xBet", "votes": 0, "license": "Attribution 4.0 International (CC BY 4.0)", "size_mb": 0.1621, "downloads": 4, "file_types": [ "CSV" ], "dataset_link": "https://www.kaggle.com/datasets/smartoddstenis/tennis-closing-odds-pinnacle-vs-1xbet", "usability_score": 8.82, "last_updated_date": "2026-09-26" }, { "owner": "Richard (Ryszard) Cieplechowicz", "title": "Tampa Bay Owner Home Values by ZIP 2020-2024", "votes": 1, "license": "Attribution 4.0 International (CC BY 4.0)", "size_mb": 0.0375, "downloads": 10, "file_types": [ "MD", "PY", "JSON" ], "dataset_link": "https://www.kaggle.com/datasets/richardcieplechowicz/tampa-bay-owner-home-values-by-zcta-2020-2024", "usability_score": 4.71, "last_updated_date": "2026-09-26" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"kaggle.com/search_datasets","input":{"sort":"recently_updated","query":"house prices","file_type":"csv","max_results":25}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find me the most upvoted Kaggle datasets about credit card fraud detection, CSV only, top 30. - I need recently updated datasets on electric vehicle charging stations — show sizes, licenses and how usable they are. - What are the newest public datasets on Kaggle covering climate change temperature records? Give me 10. - Looking for parquet-format datasets on NYC taxi trips, sorted by usability score, up to 50 results. - Pull up the hottest datasets on mental health surveys right now, with download counts and file types. ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "hottest", "most_votes", "newest", "recently_updated", "most_usable" ], "type": "string", "default": "hottest", "description": "How Kaggle orders the results, for example most_votes." }, "query": { "type": "string", "minLength": 1, "description": "Topic to search for, for example house prices." }, "file_type": { "enum": [ "any", "csv", "json", "sqlite", "bigquery", "parquet" ], "type": "string", "default": "any", "description": "Only include datasets of this file format, for example csv." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of datasets to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "datasets" ], "properties": { "datasets": { "type": "array", "items": { "type": "object", "required": [ "title", "owner", "size_mb", "file_types", "usability_score", "votes", "downloads", "last_updated_date", "license", "dataset_link" ], "properties": { "owner": { "type": [ "string", "null" ], "description": "Dataset owner." }, "title": { "type": [ "string", "null" ], "description": "Dataset title." }, "votes": { "type": [ "integer", "null" ], "description": "Number of votes." }, "license": { "type": [ "string", "null" ], "description": "Dataset license." }, "size_mb": { "type": [ "number", "null" ], "description": "Dataset size in decimal megabytes." }, "downloads": { "type": [ "integer", "null" ], "description": "Number of downloads." }, "file_types": { "type": "array", "items": { "type": "string" }, "description": "File formats found in the dataset." }, "dataset_link": { "type": "string", "description": "Link to the dataset on Kaggle." }, "usability_score": { "type": [ "number", "null" ], "description": "Kaggle usability score from 0 to 10." }, "last_updated_date": { "type": [ "string", "null" ], "description": "Most recent update date (YYYY-MM-DD)." } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Hugging Face API: Search datasets](https://fous.com/methods/huggingface.co/search-datasets.md): Finds public Hugging Face datasets by name or topic, ordered by downloads, likes, trending score or last update. - [Hugging Face API: Search models](https://fous.com/methods/huggingface.co/search-models.md): Finds public Hugging Face models by search words, with an optional task and sort order. License is null when the model does not publish one. - [Reddit API: Search posts](https://fous.com/methods/reddit.com/search-posts.md): Finds public Reddit posts by topic, optionally in one community, for a time window and sort order. Returns up to 100 posts in Reddit search order with score, comment count, text and link. - [GitHub API: Search repositories](https://fous.com/methods/github.com/search-repositories.md): Finds public GitHub repositories by keywords, with an optional language filter and sort order. Returns up to 100 matches. - [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result. - [Coursera API: Search courses](https://fous.com/methods/coursera.org/search-courses.md): Finds Coursera courses, specializations, professional certificates, degrees and guided projects on a topic, in Coursera's search order. - [Bluesky API: Search posts](https://fous.com/methods/bsky.app/search-posts.md): Searches public Bluesky posts for words, optionally ordered by latest or top and filtered by date, author or language. Search indexing may lag behind new posts. - [Chewy API: Search products](https://fous.com/methods/chewy.com/search-products.md): Search Chewy products by words, pet type, and sort order. Returns up to 72 products in Chewy's order, including listed and first-order Autoship prices when shown.