\r \r

🔍 Find API | 寻找可靠数据源\r

\r

The comprehensive guide to reliable data APIs. Stop scraping, start using APIs.\r \r 跨领域可靠数据 API 的综合指南。停止爬取，开始使用 API。\r \r

⚠️ Core Principle | 核心原则\r

\r API First, Scraping Last.\r \r | Priority | Method | When to Use | 优先级 | 方法 | 何时使用 |\r |----------|--------|-------------|--------|------|---------|\r | 1st | Official API | Always check first | 第一 | 官方 API | 始终优先检查 |\r | 2nd | Third-party API | When official API unavailable/expensive | 第二 | 第三方 API | 当官方 API 不可用/太贵 |\r | 3rd | Public Dataset | For historical/static data | 第三 | 公共数据集 | 用于历史/静态数据 |\r | 4th | Web Scraping | Only as last resort | 第四 | 网页爬取 | 仅作为最后手段 |\r \r

📋 Table of Contents | 目录\r

\r

1. Stock & Financial Data | 股票与金融数据\r
2. Weather Data | 天气数据\r
3. News & Media | 新闻与媒体\r
4. Maps & Geolocation | 地图与地理定位\r
5. E-commerce & Products | 电商与商品\r
6. More domains coming soon... | 更多领域持续完善中...\r \r ---\r \r

1. Stock & Financial Data | 股票与金融数据\r

\r

1.1 A股市场 / Chinese A-Share Market\r

\r | API | Rating | Cost | Auth | Data Coverage |\r |-----|--------|------|------|---------------|\r | AKShare | ⭐⭐⭐⭐⭐ | Free | None | Real-time quotes, historical K-lines, financial statements, fund flows, dragon-tiger list |\r | Tushare | ⭐⭐⭐⭐⭐ | Free+Paid | Token | Real-time quotes, historical data, financial statements, margin trading |\r | East Money API | ⭐⭐⭐⭐ | Free | None | Real-time quotes, fund flows, research reports |\r \r Recommended: AKShare (Best for most use cases)\r \r Installation:\r

pip install akshare\r
```\r
\r
**Quick Examples:**\r
```python\r
import akshare as ak\r
\r
# 获取A股实时行情\r
df = ak.stock_zh_a_spot_em()\r
\r
# 获取个股历史数据\r
df = ak.stock_zh_a_hist(symbol="000001", period="daily", adjust="qfq")\r
\r
# 获取财务指标\r
df = ak.stock_financial_analysis_indicator(symbol="000001")\r
\r
# 获取资金流向\r
df = ak.stock_individual_fund_flow(stock="000001")\r
```\r
\r
**Documentation:** https://akshare.akfamily.xyz\r
\r
---\r
\r
### 1.2 港股市场 / Hong Kong Stock Market\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Real-time quotes, historical data |\r
| **Tushare** | ⭐⭐⭐⭐ | Free+Paid | Token | Hong Kong stock data |\r
\r
**Recommended: AKShare**\r
\r
**Quick Examples:**\r
```python\r
import akshare as ak\r
\r
# 港股实时行情\r
df = ak.stock_hk_spot_em()\r
\r
# 个股历史数据（如腾讯 00700）\r
df = ak.stock_hk_hist(symbol="00700", period="daily", adjust="qfq")\r
\r
# 港股通资金\r
df = ak.stock_hk_ggt_components_em()\r
```\r
\r
---\r
\r
### 1.3 美股市场 / US Stock Market\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **yfinance** | ⭐⭐⭐⭐⭐ | Free | None | Real-time quotes, historical data, financials, options |\r
| **Alpha Vantage** | ⭐⭐⭐⭐ | Free+Paid | API Key | Quotes, technical indicators, forex |\r
| **Polygon.io** | ⭐⭐⭐⭐ | Free+Paid | API Key | Real-time data, options |\r
\r
**Recommended: yfinance** (Best free option for US stocks)\r
\r
**Installation:**\r
```bash\r
pip install yfinance\r
```\r
\r
**Quick Examples:**\r
```python\r
import yfinance as yf\r
\r
# 获取股票信息\r
stock = yf.Ticker("AAPL")\r
\r
# 历史数据\r
hist = stock.history(period="1mo")\r
\r
# 财务报表\r
financials = stock.financials\r
balance_sheet = stock.balance_sheet\r
cashflow = stock.cashflow\r
\r
# 股息信息\r
dividends = stock.dividends\r
\r
# 推荐分析师评级\r
recommendations = stock.recommendations\r
```\r
\r
**Documentation:** https://github.com/ranaroussi/yfinance\r
\r
---\r
\r
### 1.4 期货与衍生品 / Futures & Derivatives\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Domestic futures, international futures |\r
| **Tushare** | ⭐⭐⭐⭐ | Free+Paid | Token | Futures data |\r
\r
**Quick Examples:**\r
```python\r
import akshare as ak\r
\r
# 国内期货主力合约\r
df = ak.futures_zh_main_sina()\r
\r
# 国际期货\r
df = ak.futures_foreign_hist(symbol="CL")  # 原油\r
```\r
\r
---\r
\r
### 1.5 基金数据 / Fund Data\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **AKShare** | ⭐⭐⭐⭐⭐ | Free | None | Open-end funds, ETFs, money funds |\r
| **East Money API** | ⭐⭐⭐⭐ | Free | None | Fund rankings, holdings |\r
\r
**Quick Examples:**\r
```python\r
import akshare as ak\r
\r
# 开放式基金列表\r
df = ak.fund_open_fund_info_em(fund="000001")\r
\r
# ETF实时行情\r
df = ak.fund_etf_spot_em()\r
\r
# 基金持仓\r
df = ak.fund_portfolio_em(fund="000001")\r
```\r
\r
---\r
\r
## 2. Weather Data | 天气数据\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **OpenWeatherMap** | ⭐⭐⭐⭐⭐ | Free+Paid | API Key | Current weather, forecast, historical |\r
| **WeatherAPI.com** | ⭐⭐⭐⭐ | Free+Paid | API Key | Weather, astronomy, sports |\r
| **QWeather 和风天气** | ⭐⭐⭐⭐ | Free+Paid | API Key | 中国地区天气数据 |\r
\r
**Recommended: OpenWeatherMap** (Global coverage)\r
\r
**Quick Examples:**\r
```python\r
import requests\r
\r
api_key = "YOUR_API_KEY"\r
city = "Beijing"\r
\r
# 当前天气\r
url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric"\r
response = requests.get(url)\r
data = response.json()\r
\r
print(f"Temperature: {data['main']['temp']}°C")\r
print(f"Weather: {data['weather'][0]['description']}")\r
```\r
\r
**Get API Key:** https://openweathermap.org/api\r
\r
---\r
\r
## 3. News & Media | 新闻与媒体\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **NewsAPI** | ⭐⭐⭐⭐⭐ | Free+Paid | API Key | Global news articles |\r
| **GNews** | ⭐⭐⭐⭐ | Free+Paid | API Key | News articles, search |\r
| **MediaStack** | ⭐⭐⭐⭐ | Free+Paid | API Key | News data |\r
\r
**Recommended: NewsAPI**\r
\r
**Quick Examples:**\r
```python\r
import requests\r
\r
api_key = "YOUR_API_KEY"\r
\r
# 获取头条新闻\r
url = f"https://newsapi.org/v2/top-headlines?country=us&apiKey={api_key}"\r
response = requests.get(url)\r
articles = response.json()['articles']\r
\r
for article in articles[:5]:\r
    print(article['title'])\r
```\r
\r
**Get API Key:** https://newsapi.org\r
\r
---\r
\r
## 4. Maps & Geolocation | 地图与地理定位\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **OpenStreetMap Nominatim** | ⭐⭐⭐⭐⭐ | Free | None | Geocoding, reverse geocoding |\r
| **高德地图 API** | ⭐⭐⭐⭐⭐ | Free+Paid | API Key | 中国地区地图、导航、POI |\r
| **百度地图 API** | ⭐⭐⭐⭐ | Free+Paid | API Key | 中国地区地图、导航 |\r
| **Google Maps API** | ⭐⭐⭐⭐ | Paid | API Key | Global maps, places, routes |\r
\r
**Recommended: Nominatim** (Free, no auth) | **高德地图** (中国地区)\r
\r
**Nominatim Quick Examples:**\r
```python\r
import requests\r
\r
# 地理编码（地址转坐标）\r
address = "Beijing, China"\r
url = f"https://nominatim.openstreetmap.org/search?q={address}&format=json"\r
response = requests.get(url, headers={'User-Agent': 'AgentApp'})\r
data = response.json()\r
\r
print(f"Lat: {data[0]['lat']}, Lon: {data[0]['lon']}")\r
```\r
\r
**高德地图 Quick Examples:**\r
```python\r
import requests\r
\r
api_key = "YOUR_API_KEY"\r
address = "北京市朝阳区"\r
\r
# 地理编码\r
url = f"https://restapi.amap.com/v3/geocode/geo?address={address}&key={api_key}"\r
response = requests.get(url)\r
data = response.json()\r
\r
print(data['geocodes'][0]['location'])\r
```\r
\r
**Get 高德 API Key:** https://lbs.amap.com\r
\r
---\r
\r
## 5. E-commerce & Products | 电商与商品\r
\r
| API | Rating | Cost | Auth | Data Coverage |\r
|-----|--------|------|------|---------------|\r
| **淘宝开放平台** | ⭐⭐⭐⭐ | Free+Paid | OAuth | 商品搜索, 订单 |\r
| **京东开放平台** | ⭐⭐⭐⭐ | Free+Paid | OAuth | 商品, 订单, 物流 |\r
| **Barcode Lookup** | ⭐⭐⭐ | Free+Paid | API Key | Product info by barcode |\r
\r
**Note:** 电商API通常需要商家认证，普通用户可考虑爬取商品页面或使用第三方服务。\r
\r
---\r
\r
## 6. More domains coming soon... | 更多领域持续完善中\r
\r
**Planned additions:**\r
- Social Media APIs (Twitter, Weibo, Reddit)\r
- Translation APIs\r
- Image & Video APIs\r
- Scientific & Research Data APIs\r
- Government & Public Data APIs\r
- Real Estate Data APIs\r
- Job & Recruitment APIs\r
\r
**Contribute:** If you know reliable APIs in other domains, help expand this skill!\r
\r
---\r
\r
## 🔄 Decision Flow | 决策流程\r
\r
```\r
用户需要获取外部数据\r
    ↓\r
Step 1: 确定数据类型\r
├── 股票/金融 → 查看本 Skill 第1节\r
├── 天气 → 查看本 Skill 第2节\r
├── 新闻 → 查看本 Skill 第3节\r
├── 地图/位置 → 查看本 Skill 第4节\r
├── 电商/商品 → 查看本 Skill 第5节\r
└── 其他 → 搜索 RapidAPI / Public APIs\r
    ↓\r
Step 2: 选择合适的 API\r
├── 考虑因素：成本、认证难度、数据覆盖、稳定性\r
└── 优先选择免费/免认证的 API\r
    ↓\r
Step 3: 检查环境\r
├── Python库是否安装？→ pip install xxx\r
└── API Key是否获取？→ 引导用户注册\r
    ↓\r
Step 4: 调用 API 获取数据\r
    ↓\r
Step 5: 返回结构化结果\r
```\r
\r
## 📊 Before vs After Comparison | 效果对比\r
\r
| Metric | Web Scraping | Using API |\r
|--------|-------------|-----------|\r
| **Speed** | 30-60 seconds | 1-3 seconds |\r
| **Token Cost** | High (entire HTML) | Low (JSON only) |\r
| **Accuracy** | Low (parsing errors) | High (structured data) |\r
| **Reliability** | Low (anti-scraping) | High (stable API) |\r
| **Maintenance** | High (page changes) | Low (stable API) |\r
\r
| 指标 | 网页爬取 | 使用 API |\r
|------|---------|---------|\r
| **速度** | 30-60 秒 | 1-3 秒 |\r
| **Token 成本** | 高（整个页面） | 低（仅 JSON） |\r
| **准确性** | 低（解析错误） | 高（结构化数据） |\r
| **稳定性** | 低（反爬机制） | 高（稳定接口） |\r
| **维护成本** | 高（页面变化） | 低（稳定接口） |\r
\r
## 🔧 General Setup | 通用安装\r
\r
Most APIs in this skill require Python. Basic setup:\r
\r
```bash\r
# 常用数据获取库\r
pip install akshare yfinance requests pandas\r
\r
# 可选：更多数据源\r
pip install tushare\r
```\r
\r
## 🔍 External Resources | 外部资源\r
\r
If the data type is not covered in this skill, search these directories:\r
\r
| Resource | URL | Description |\r
|----------|-----|-------------|\r
| **RapidAPI** | https://rapidapi.com/hub | Largest API marketplace |\r
| **Public APIs** | https://github.com/public-apis/public-apis | Free public APIs list |\r
| **ProgrammableWeb** | https://www.programmableweb.com | API directory |\r
\r
## 📝 Version | 版本\r
\r
- Version: 1.0.0\r
- Created: 2026-03-13\r
- Last Updated: 2026-03-13\r
- Maintainer: Community\r
- Contribution: Welcome to add more reliable data sources\r
\r
---\r
\r
**Remember: API First, Scraping Last.**\r