[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72386":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},72386,"oxylabs-ai-studio-py","oxylabs\u002Foxylabs-ai-studio-py","oxylabs","Structured data gathering from any website using AI-powered scraper, crawler, and browser automation. Scraping and crawling with natural language prompts. Equip your LLM agents with fresh data. AI Studio python SDK for intelligent web data gathering. ","https:\u002F\u002Faistudio.oxylabs.io\u002F",null,"Python",2944,27,8,1,0,67,63.04,"MIT License",false,"main",true,[24,25,26,27,28,29,30,31,32,33,34,35],"ai-crawler","ai-scraper","ai-scraping","ai-search","ai-tools","ai-web-scraper","proxy-scraper","python-ai","web-scraping","web-scraping-ai","web-scraping-api","web-scraping-python","2026-06-12 04:01:04","# OxyLabs AI Studio Python SDK\n\n[![AI-Studio Python (1)](https:\u002F\u002Fgithub.com\u002Foxylabs\u002Foxylabs-ai-studio-py\u002Fblob\u002Fmain\u002FAi-Studio2.png)](https:\u002F\u002Faistudio.oxylabs.io\u002F?utm_source=877&utm_medium=affiliate&utm_campaign=ai_studio&groupid=877&utm_content=ai-studio-js-github&transaction_id=102f49063ab94276ae8f116d224b67) \n\n[![](https:\u002F\u002Fdcbadge.limes.pink\u002Fapi\u002Fserver\u002FPds3gBmKMH?style=for-the-badge&theme=discord)](https:\u002F\u002Fdiscord.gg\u002FPds3gBmKMH) [![YouTube](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-Oxylabs-red?style=for-the-badge&logo=youtube&logoColor=white)](https:\u002F\u002Fwww.youtube.com\u002F@oxylabs)\n\nA simple Python SDK for seamlessly interacting with [Oxylabs AI Studio API](https:\u002F\u002Faistudio.oxylabs.io\u002F) services, including AI-Scraper, AI-Crawler, AI-Browser-Agent and other data extraction tools.\n\n## Requirements\n- python 3.10 and above\n- API KEY\n\n## Installation\n\n```bash\npip install oxylabs-ai-studio\n```\n\n## Usage\n\n### Crawl (`AiCrawler.crawl`)\n\n```python\n\nfrom oxylabs_ai_studio.apps.ai_crawler import AiCrawler\n\ncrawler = AiCrawler(api_key=\"\u003CAPI_KEY>\")\n\nurl = \"https:\u002F\u002Foxylabs.io\"\nresult = crawler.crawl(\n    url=url,\n    user_prompt=\"Find all pages with proxy products pricing\",\n    output_format=\"markdown\",\n    render_javascript=False,\n    return_sources_limit=3,\n    geo_location=\"United States\",\n)\nprint(\"Results:\")\nfor item in result.data:\n    print(item, \"\\n\")\n\n```\n\n**Parameters:**\n- `url` (str): Starting URL to crawl (**required**)\n- `user_prompt` (str): Natural language prompt to guide extraction (**required**)\n- `output_format` (Literal[\"json\", \"markdown\", \"csv\", \"toon\"]): Output format (default: \"markdown\")\n- `schema` (dict | None): Json schema for structured extraction (required if output_format is \"json\", \"csv\" or \"toon\")\n- `render_javascript` (bool): Render JavaScript (default: False)\n- `return_sources_limit` (int): Max number of sources to return (default: 25)\n- `geo_location` (str): Proxy location in ISO2 format or country canonical name. See [docs](https:\u002F\u002Fdevelopers.oxylabs.io\u002Fscraping-solutions\u002Fweb-scraper-api\u002Ffeatures\u002Flocalization\u002Fproxy-location#list-of-supported-geo_location-values)\n- `max_credits` (int | None): Maximum of credits to use (optional)\n\n### Scrape (`AiScraper.scrape`)\n\n```python\nfrom oxylabs_ai_studio.apps.ai_scraper import AiScraper\n\nscraper = AiScraper(api_key=\"\u003CAPI_KEY>\")\n\nschema = scraper.generate_schema(prompt=\"want to parse developer, platform, type, price game title, genre (array) and description\")\nprint(f\"Generated schema: {schema}\")\n\nurl = \"https:\u002F\u002Fsandbox.oxylabs.io\u002Fproducts\u002F3\"\nresult = scraper.scrape(\n    url=url,\n    output_format=\"json\",\n    schema=schema,\n    render_javascript=False,\n)\nprint(result)\n\n```\n**Parameters:**\n- `url` (str): Target URL to scrape (**required**)\n- `output_format` (Literal[\"json\", \"markdown\", \"csv\", \"screenshot\", \"toon\"]): Output format (default: \"markdown\")\n- `schema` (dict | None): JSON schema for structured extraction (required if output_format is \"json\", \"csv\" or \"toon\")\n- `render_javascript` (bool | string): Render JavaScript. Can be set to \"auto\", meaning the service will detect if rendering is needed (default: False)\n- `geo_location` (str): Proxy location in ISO2 format or country canonical name. See [docs](https:\u002F\u002Fdevelopers.oxylabs.io\u002Fscraping-solutions\u002Fweb-scraper-api\u002Ffeatures\u002Flocalization\u002Fproxy-location#list-of-supported-geo_location-values)\n- `user_agent` (str): User-Agent request header. See more at https:\u002F\u002Fdevelopers.oxylabs.io\u002Fscraping-solutions\u002Fweb-scraper-api\u002Ffeatures\u002Fhttp-context-and-job-management\u002Fuser-agent-type.\n\n### Browser Agent (`BrowserAgent.run`)\n\n```python\nfrom oxylabs_ai_studio.apps.browser_agent import BrowserAgent\n\nbrowser_agent = BrowserAgent(api_key=\"\u003CAPI_KEY>\")\n\nschema = browser_agent.generate_schema(\n    prompt=\"game name, platform, review stars and price\"\n)\nprint(\"schema: \", schema)\n\nprompt = \"Find if there is game 'super mario odyssey' in the store. If there is, find the price. Use search bar to find the game.\"\nurl = \"https:\u002F\u002Fsandbox.oxylabs.io\u002F\"\nresult = browser_agent.run(\n    url=url,\n    user_prompt=prompt,\n    output_format=\"json\",\n    schema=schema,\n)\nprint(result.data)\n```\n\n**Parameters:**\n- `url` (str): Starting URL to browse (**required**)\n- `user_prompt` (str): Natural language prompt for extraction (**required**)\n- `output_format` (Literal[\"json\", \"markdown\", \"html\", \"screenshot\", \"csv\", \"toon\"]): Output format (default: \"markdown\")\n- `schema` (dict | None): Json schema for structured extraction (required if output_format is \"json\", \"csv\" or \"toon\")\n- `geo_location` (str): Proxy location in ISO2 format or country canonical name. For example 'Germany' (capitalized).\n\n### Search (`AiSearch.search`)\n\n```python\nfrom oxylabs_ai_studio.apps.ai_search import AiSearch\n\n\nsearch = AiSearch(api_key=\"\u003CAPI_KEY>\")\n\nquery = \"lasagna recipe\"\nresult = search.search(\n    query=query,\n    limit=5,\n    render_javascript=False,\n    return_content=True,\n)\nprint(result.data)\n\n# Or for fast search\nresult = search.instant_search(\n    query=query,\n    limit=10,\n)\nprint(result.data)\n```\n\n**Parameters:**\n- `query` (str): What to search for (**required**)\n- `limit` (int): Maximum number of results to return (default: 10, maximum: 50)\n- `render_javascript` (bool): Render JavaScript (default: False)\n- `return_content` (bool): Whether to return markdown contents in results (default: True)\n- `geo_location` (*string*): ISO 2-letter format, country name, coordinate formats are supported. See more at [SERP Localization](https:\u002F\u002Fdevelopers.oxylabs.io\u002Fscraping-solutions\u002Fweb-scraper-api\u002Ffeatures\u002Flocalization\u002Fserp-localization).\n\n> **Note:** When `limit \u003C= 10` and `return_content=False`, the search automatically uses the instant endpoint (`\u002Fsearch\u002Finstant`) which returns results immediately without polling, providing faster response times.\n\nInstant search supported parameters:\n- `query` (*string*): The search query.\n- `limit` (*integer*): The maximum number of search results to return. Maximum: 10.\n- `geo_location` (*string*): Google's canonical name of the location. See more at [Google Ads GeoTargets](https:\u002F\u002Fdevelopers.google.com\u002Fgoogle-ads\u002Fapi\u002Fdata\u002Fgeotargets).\n\n\n### Map (`AiMap.map`)\n```python\nfrom oxylabs_ai_studio.apps.ai_map import AiMap\n\n\nai_map = AiMap(api_key=\"\u003CAPI_KEY>\")\npayload = {\n    \"url\": \"https:\u002F\u002Fcareer.oxylabs.io\",\n    \"search_keywords\": [\"career\", \"jobs\", \"vacancy\"],\n    \"user_prompt\": \"job ad pages\",\n    \"max_crawl_depth\": 2,\n    \"limit\": 10,\n    \"geo_location\": \"Germany\",\n    \"render_javascript\": False,\n    \"include_sitemap\": True,\n    \"max_credits\": None,\n    \"allow_subdomains\": False,\n    \"allow_external_domains\": False,\n}\nresult = ai_map.map(**payload)\nprint(result.data)\n```\n**Parameters:**\n- `url` (str): Starting URL or domain to map (**required**)\n- `search_keywords` (list[str]): Keywords for URLs paths filtering (default: None)\n- `user_prompt` (str | None): Natural language prompt for keyword search. Can be used together with 'search_keywords' or standalone (optional)\n- `max_crawl_depth` (int): Max crawl depth (1..5, default: 1)\n- `limit` (int): Max number of URLs to return (default: 25)\n- `geo_location` (str): Proxy location in ISO2 format or country canonical name. See [docs](https:\u002F\u002Fdevelopers.oxylabs.io\u002Fscraping-solutions\u002Fweb-scraper-api\u002Ffeatures\u002Flocalization\u002Fproxy-location#list-of-supported-geo_location-values)\n- `render_javascript` (bool): JavaScript rendering (default: False)\n- `include_sitemap` (bool): Whether to include sitemap as seed (default: True)\n- `max_credits` (int | None): Maximum of credits to use (optional)\n- `allow_subdomains` (bool): Include subdomains (default: False)\n- `allow_external_domains` (bool): Include external domains (default: False)\n\n---\nSee the [examples](https:\u002F\u002Fgithub.com\u002Foxylabs\u002Foxylabs-ai-studio-py\u002Ftree\u002Fmain\u002Fexamples) folder for usage examples of each method. Each method has corresponding async version.\n","OxyLabs AI Studio Python SDK 是一个用于从任何网站智能收集结构化数据的工具，它集成了AI驱动的爬虫、抓取器和浏览器自动化功能。该SDK允许用户通过自然语言指令进行网页抓取和爬取，支持多种输出格式如JSON、Markdown等，并能够自动生成JSON模式以实现更精准的数据提取。其核心特性包括无需手动编写复杂的解析逻辑即可获取所需信息，以及支持JavaScript渲染和地理位置定位等功能。适用于需要快速准确地从互联网上获取最新数据以供大语言模型训练或数据分析的场景。",2,"2026-06-11 03:41:50","high_star"]