media

Buscar fotos e vídeos gratuitos de bancos de imagens

Pesquisa no Pixabay (fotos e vídeos gratuitos). Nada é armazenado: importe o resultado escolhido. preview_url serve apenas para visualizar um resultado.

GET/v1/sites/{site_id}/media/stock

Request

curl --request GET \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>", {
  method: "GET",
  headers: {
    "Authorization": "<api-key>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/media/stock?query=<query>")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "results": [
      {
        "provider": "pixabay",
        "id": "<string>",
        "kind": "image",
        "width": 123.45,
        "height": 123.45,
        "duration": 123.45,
        "description": "<string>",
        "author": "<string>",
        "author_url": null,
        "page_url": "<string>",
        "preview_url": "<string>"
      }
    ],
    "total": 123,
    "page": 123,
    "attribution": "<string>",
    "providers": {},
    "next_action": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Requer sites:read. Não custa créditos nem armazena nada.

Cada resultado inclui provider, id, tamanho, descrição, autor e preview_url. A prévia serve apenas para visualizar o resultado: o site nunca aponta para ela. Importe o resultado escolhido para copiá-lo para a mídia do site.

providers informa quais bibliotecas podem ser pesquisadas no momento, por exemplo, { "pixabay": "available" }. Listar os modelos retorna as mesmas informações antes de qualquer busca. Se você indicar uma biblioteca indisponível, a solicitação será recusada com service_unavailable, o nome da biblioteca em details.provider e as opções disponíveis em details.providers.

As consultas em inglês retornam mais resultados. Por enquanto, os resultados vêm apenas do Pixabay, então provider é sempre pixabay. As respostas ficam em cache por um dia.

O limite é de 30 buscas e importações por minuto por workspace. Se o limite for excedido ou a própria biblioteca estiver ocupada (há uma única cota compartilhada por todos os usuários do Atelier201), a resposta será 429 rate_limited, com o tempo de espera em Retry-After e details.retry_after_seconds: aguarde esse tempo e tente novamente.

Autorizações

Authorizationbearerin headerrequired

Parâmetros de caminho

site_idstringrequired

O id do site ou seu slug (o endereço antes de .atelier201.page).

Parâmetros de consulta

querystringrequiredlength: 1–100 chars

O que procurar. A busca em inglês retorna mais resultados.

kindenum<string>one of: image, video

image (padrão) ou video.

orientationenum<string>one of: landscape, portrait, square

providerenum<string>one of: pixabay

A biblioteca. Por enquanto, Pixabay é a única opção e também o padrão.

per_pageintegerrange: 1–30

pageintegerrange: 1–50

localestringlength: ≤ 10 chars

O idioma da consulta, por exemplo, fr-FR.

Resposta

application/json

Pesquisar fotos e vídeos gratuitos de bancos de imagens

dataobjectrequired

Show child attributes

data.resultsobject[]required

Show child attributes

data.results.providerenum<string>requiredone of: pixabay

data.results.idstringrequired

data.results.kindenum<string>requiredone of: image, video

data.results.widthnumberrequired

data.results.heightnumberrequired

data.results.durationnumber

data.results.descriptionstringrequired

data.results.authorstringrequired

data.results.author_urlstringnullrequired

data.results.page_urlstringrequired

data.results.preview_urlstringrequired

Serve apenas para visualizar o resultado. Um site nunca cria um link para ele: importe o arquivo.

data.totalintegerrequiredrange: -9007199254740991–9007199254740991

data.pageintegerrequiredrange: -9007199254740991–9007199254740991

data.attributionstringrequired

data.providersRecord<string, enum<string>>required

Cada biblioteca de mídia e se ela pode ser pesquisada agora, por exemplo, { pixabay: available }.

data.next_actionstringrequired

request_idstringrequired

{ "data": { "results": [ { "provider": "pixabay", "id": "<string>", "kind": "image", "width": 123.45, "height": 123.45, "duration": 123.45, "description": "<string>", "author": "<string>", "author_url": null, "page_url": "<string>", "preview_url": "<string>" } ], "total": 123, "page": 123, "attribution": "<string>", "providers": {}, "next_action": "<string>" }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Buscar fotos e vídeos gratuitos de bancos de imagens

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies