使用这个快速简单的API实时在网络上搜索图片。由谷歌图片提供支持。支持谷歌高级图片搜索的所有过滤器。
获取来自网络的实时图像搜索结果 支持所有Google图片搜索过滤器
搜索图片 - 端点功能
| 对象 | 描述 |
|---|---|
query |
[必需] Search query / keyword |
limit |
[必需] Maximum number of results to return. Default: 10 Allowed values: 1-100 |
size |
可选 Find images of a specific size. Default: any Allowed values: any, large, medium, icon, 400x300_and_more, 640x480_and_more, 800x600_and_more, 1024x768_and_more, 2mp_and_more, 4mp_and_more, 6mp_and_more, 8mp_and_more, 10mp_and_more, 12mp_and_more, 15mp_and_more, 20mp_and_more, 40mp_and_more, 70mp_and_more |
color |
可选 Find images with a specific dominant color. Default: any Allowed values: any, red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown, full, transparent, grayscale |
type |
可选 Default: any Allowed values: any, face, photo, clipart, lineart, animated |
time |
可选 Find images last updated in a specific time range. Default: any Allowed values: any, day, week, month, year |
usage_rights |
可选 Find images with specific usage rights / license / copyright. Default: any Allowed values: any, creative_commons, commercial |
file_type |
可选 Find images of a specific format / file type. Default: any Allowed values: any, jpg, jpeg, png, gif, svg, webp, ico, raw |
aspect_ratio |
可选 Find images with a specific aspect ratio. Default: any Allowed values: any, tall, square, wide, panoramic |
safe_search |
可选 How to show explicit content in your search results, like sexual activity and graphic violence. Default: blur Allowed values: off, blur, on |
region |
可选 The country / region from which to make the query. Default: us Allowed values: 2-letter country code, see ISO 3166-1 alpha-2 |
fields |
可选 A comma separated list of image fields to include in the response (field projection). By default all fields are returned. Example: title,size,thumbnail_url,position |
{
"status": "OK",
"request_id": "c2c8943e-f0fa-4b70-b7d1-74bfec5782d2",
"parameters": {
"query": "beach",
"region": "us",
"safe_search": "off",
"size": "any",
"color": "any",
"type": "any",
"file_type": "any",
"time": "any",
"aspect_ratio": "any",
"usage_rights": "any"
},
"data": [
{
"id": "OCzrEomHmmfB3M",
"title": "Science of Summer: Where Does Beach Sand Come From? | Live Science",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSFrow6dfi3m4OD58stlciQ5UV10d_H25ullw&s",
"width": 183,
"height": 275,
"size": "142KB",
"background_color": "rgb(74,176,240)",
"thumbnail_url": "https://cdn.mos.cms.futurecdn.net/wtqqnkYDYi2ifsWZVW2MT4-1200-80.jpg",
"thumbnail_width": 667,
"thumbnail_height": 1000,
"source": "Live Science",
"source_url": "https://www.livescience.com/38163-where-beach-sand-comes-from.html",
"source_domain": "www.livescience.com",
"position": 1,
"rank": 1
},
{
"id": "CpHQgasK7a-dtM",
"title": "Top 5 most beautiful beaches in the world | Magazine PONANT",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTrUEwTA_0c9cuzkrI6daqRlb4XvES_ioa42Q&s",
"width": 179,
"height": 281,
"size": "78KB",
"background_color": "rgb(126,171,216)",
"thumbnail_url": "https://aebc975c.rocketcdn.me/wp-content/uploads/2020/12/plage.jpg",
"thumbnail_width": 800,
"thumbnail_height": 1254,
"source": "Escales - Ponant",
"source_url": "https://escales.ponant.com/en/top-5-beaches/",
"source_domain": "escales.ponant.com",
"position": 2,
"rank": 2
},
{
"id": "5XSoi3wo2tXqAM",
"title": "Beach - Wikipedia",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRYwzUuJSpaWN5l8zd7kJI1MnwPMWHyKM-Lkg&s",
"width": 183,
"height": 275,
"size": "287KB",
"background_color": "rgb(78,130,168)",
"thumbnail_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/7/73/Beach_at_Fort_Lauderdale.jpg/1200px-Beach_at_Fort_Lauderdale.jpg",
"thumbnail_width": 800,
"thumbnail_height": 1200,
"source": "Wikipedia",
"source_url": "https://en.wikipedia.org/wiki/Beach",
"source_domain": "en.wikipedia.org",
"position": 3,
"rank": 3
},
{
"id": "5V4GGfXpatZ9eM",
"title": "Best beaches to visit in 2024, according to Tripadvisor reviews: See which sandy spots made the list | Fox News",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQuH9yhYPhnk_P7K7BJY4krUAY_9fav7MPQgw&s",
"width": 168,
"height": 300,
"size": "666KB",
"background_color": "rgb(139,206,248)",
"thumbnail_url": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2024/02/1200/675/poipu.jpg?ve=1&tl=1",
"thumbnail_width": 675,
"thumbnail_height": 1200,
"source": "Fox News",
"source_url": "https://www.foxnews.com/lifestyle/best-us-beaches-visit-tripadvisor-reviews-see-sandy-spots-made-list",
"source_domain": "www.foxnews.com",
"position": 4,
"rank": 4
},
{
"id": "xsCdF1SI_AfyWM",
"title": "Beach",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTrme3ZMRvChIOz_b-O0kavkY_qxALNJUqbNQ&s",
"width": 225,
"height": 225,
"size": "61KB",
"background_color": "rgb(88,123,184)",
"thumbnail_url": "https://images.nationalgeographic.org/image/upload/t_RL2_search_thumb/v1638889927/EducationHub/photos/pebble-beach.jpg",
"thumbnail_width": 600,
"thumbnail_height": 600,
"source": "National Geographic Society",
"source_url": "https://www.nationalgeographic.org/encyclopedia/beach/",
"source_domain": "www.nationalgeographic.org",
"position": 5,
"rank": 5
},
{
"id": "3gLhuagnyEZe2M",
"title": "Sunset Beach — The Tree House Hawaii",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoIkad6Qsweh4rezsN_FwAPS-O3cqxZfFVIA&s",
"width": 183,
"height": 275,
"size": "399KB",
"background_color": "rgb(160,160,160)",
"thumbnail_url": "https://images.squarespace-cdn.com/content/v1/6091f3f14591065771a06282/1623320335727-0YR3GUXDGUWS5UBO8VB7/unsplash-image-KMn4VEeEPR8.jpg",
"thumbnail_width": 1662,
"thumbnail_height": 2500,
"source": "The Tree House Hawaii",
"source_url": "https://www.thetreehousehawaii.com/sunset-beach",
"source_domain": "www.thetreehousehawaii.com",
"position": 6,
"rank": 6
},
{
"id": "Zolck_VSJdfrnM",
"title": "Checklist: Things You Need For a Beach Vacation | Travelpro",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQZbbdbKLSHvtuISwDwrOvKVqsroq4QIr1ZGg&s",
"width": 159,
"height": 318,
"size": "121KB",
"background_color": "rgb(104,162,200)",
"thumbnail_url": "http://travelpro.com/cdn/shop/articles/shutterstock_1181523733_1024x1024.webp?v=1697120789",
"thumbnail_width": 512,
"thumbnail_height": 1024,
"source": "Travelpro",
"source_url": "https://travelpro.com/blogs/the-travelpro-blog/planning-beach-vacation-guide",
"source_domain": "travelpro.com",
"position": 7,
"rank": 7
},
{
"id": "tXKP7UvlvFjMIM",
"title": "Maui Beaches | Beaches on Maui | Go Hawaii",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRuc8VlOX66hzih11nbTG1w4hFthLHmcImGiA&s",
"width": 183,
"height": 275,
"size": "201KB",
"background_color": "rgb(133,168,216)",
"thumbnail_url": "https://www.gohawaii.com/sites/default/files/styles/image_gallery_bg_xl/public/hero-unit-images/11500_mauibeaches.jpg?itok=I2TvGlCa",
"thumbnail_width": 1280,
"thumbnail_height": 1920,
"source": "Go Hawaii",
"source_url": "https://www.gohawaii.com/islands/maui/things-to-do/beaches",
"source_domain": "www.gohawaii.com",
"position": 8,
"rank": 8
},
{
"id": "EMgAWPNgscRTNM",
"title": "26 Most Beautiful Beaches in the World",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcThOtVrdd88gO9vIw-4rk4TxqGbwXsK4RcrQQ&s",
"width": 183,
"height": 275,
"size": "109KB",
"background_color": "rgb(216,194,146)",
"thumbnail_url": "https://www.travelandleisure.com/thmb/kb1wzVyraU9YJJpH0l7BuMTGpNA=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/intro-grayton_beach_sunset_0-2000-fd27efa3b1064449aa87b3981b68e095.jpg",
"thumbnail_width": 998,
"thumbnail_height": 1500,
"source": "Travel + Leisure",
"source_url": "https://www.travelandleisure.com/trip-ideas/beach-vacations/most-beautiful-beaches-in-the-world",
"source_domain": "www.travelandleisure.com",
"position": 9,
"rank": 9
},
{
"id": "e03MC3pNht1K1M",
"title": "The 28 Most Beautiful Beaches in the World in 2024",
"url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSgiHOxdrm2b-8ETUgU--CWHw7ZcLKDUvsF8w&s",
"width": 224,
"height": 225,
"size": "61KB",
"background_color": "rgb(86,134,208)",
"thumbnail_url": "https://hips.hearstapps.com/hmg-prod/images/champagne-beach-espiritu-santo-island-vanuatu-royalty-free-image-1655672510.jpg?crop=0.668xw:1.00xh;0.167xw,0&resize=640:*",
"thumbnail_width": 639,
"thumbnail_height": 640,
"source": "Veranda",
"source_url": "https://www.veranda.com/travel/g40338994/most-beautiful-beaches-in-the-world/",
"source_domain": "www.veranda.com",
"position": 10,
"rank": 10
}
]
}
curl --location --request GET 'https://zylalabs.com/api/7334/%e5%ae%9e%e6%97%b6%e5%9b%be%e5%83%8f%e6%90%9c%e7%b4%a2+api/11640/%e6%90%9c%e7%b4%a2%e5%9b%be%e7%89%87?query=beach&limit=2' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后，请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
搜索图像端点实时返回图像搜索结果，包括图像网址 标题 尺寸 来源信息以及其他元数据如背景颜色和使用权利
响应数据中的关键字段包括"id" "title" "url" "width" "height" "size" "source"和"thumbnail_url"这些字段提供了有关搜索结果中每个图像的基本信息
用户可以使用“查询”、“区域”、“安全搜索”、“大小”、“颜色”、“类型”、“文件类型”、“时间”、“纵横比”和“使用权”等参数自定义他们的请求，以优化他们的图像搜索结果
响应数据采用JSON格式结构，包含一个“状态”字段指示请求结果，一个“请求_id”用于跟踪，“参数”反映搜索条件，以及一个“数据”数组包含单个图像结果
数据来源于谷歌图片，确保来自各种网站的广泛图片范围。这使得用户能够访问与他们的搜索查询相关的多样内容
典型的使用案例包括网页开发 内容创建和研究 用户需要快速找到相关的图像 该API还可以用于需要视觉内容的应用程序 例如博客或营销材料
用户可以通过提取关键字段如“url”来显示图像、“title”作为标题，以及“source_url”链接回原始内容来利用返回的数据，从而增强用户参与度和内容可信度
如果搜索返回部分或空结果，用户应该考虑细化他们的搜索参数，例如调整“查询”或“过滤器”，以提高返回图像的相关性和数量
Zyla API Hub 就像一个大型 API 商店，您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后，您可以选择要使用的 API。请记住，每个 API 都需要自己的订阅。但如果您订阅多个 API，您将为所有这些 API 使用相同的密钥，使事情变得更简单。
价格以 USD（美元）、EUR（欧元）、CAD（加元）、AUD（澳元）和 GBP（英镑）列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术，由 Stripe 提供支持，Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题，请通过 [email protected]
此外，如果您已经以这些货币中的任何一种（USD、EUR、CAD、AUD、GBP）拥有有效订阅，该货币将保留用于后续订阅。只要您没有任何有效订阅，您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区，仅供参考。实际价格以 USD（美元）为单位。当您付款时，即使您在我们的网站上看到以本地货币显示的等值金额，您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时，银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行，检查他们是否阻止了我们的收费。此外，您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助，请通过 [email protected]
价格由月度或年度订阅决定，具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用（由状态 200 响应指示）才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始，并在下个月的同一日期续订。因此，如果您想避免未来的费用，请提前取消订阅。
要升级您当前的订阅计划，只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效，让您立即享受新计划的功能。请注意，您之前计划中的任何剩余调用都不会转移到新计划，因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用，请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如，如果您的计划允许每月 1,000 个请求，而您已使用 100 个，则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数，请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如，如果您的计划包括每月 1,000 个请求，此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如，如果它显示 3,600，则意味着还有 3,600 秒直到限制重置。
是的，您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意，升级、降级和取消会立即生效。此外，取消后，您将不再有权访问该服务，即使您的配额中还有剩余调用。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线，时间为上午 8 点至下午 5 点（EST）。如果您在该时间之后联系我们，我们将尽快回复您。此外，您可以通过 [email protected]
为了让您有机会在没有任何承诺的情况下体验我们的 API，我们提供 7 天免费试用，允许您免费进行最多 50 次 API 调用。此试用只能使用一次，因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用，但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束，以先发生者为准。如果您在试用期间达到 50 次请求限制，您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者，如果您在第 7 天之前不取消订阅，您的免费试用将结束，您的计划将自动计费，授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后，您将被收取试用期间订阅的计划的全额费用。因此，在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时，您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用，API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求，您的付款将在此时间范围内处理。
服务级别:
100%
响应时间:
666ms
服务级别:
100%
响应时间:
626ms
服务级别:
100%
响应时间:
739ms
服务级别:
100%
响应时间:
5,862ms
服务级别:
100%
响应时间:
1,054ms
服务级别:
100%
响应时间:
659ms
服务级别:
100%
响应时间:
4,738ms
服务级别:
97%
响应时间:
1,500ms
服务级别:
100%
响应时间:
3,646ms
服务级别:
100%
响应时间:
755ms
