media

Buscar fotos y vídeos de archivo gratuitos

Busca en Pixabay (fotos y vídeos gratuitos). No se almacena nada: importa el que elijas. preview_url solo sirve para ver un 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>"
}

Requiere sites:read. No consume créditos ni guarda nada.

Cada resultado incluye provider, id, el tamaño, una descripción, el autor y preview_url. La vista previa solo sirve para consultar el resultado: un sitio nunca enlaza a ella. Importa el que elijas para copiarlo en los recursos multimedia del sitio.

providers indica qué bibliotecas se pueden consultar en ese momento, por ejemplo { "pixabay": "available" }. Consultar la lista de modelos devuelve la misma información antes de hacer una búsqueda. Si se indica una biblioteca que no está disponible, la solicitud se rechaza con service_unavailable; su nombre aparece en details.provider y las bibliotecas disponibles, en details.providers.

Las consultas en inglés devuelven más resultados. Por ahora, los resultados proceden únicamente de Pixabay, por lo que provider siempre es pixabay. Las respuestas se almacenan en caché durante un día.

Se permiten como máximo 30 búsquedas e importaciones por minuto y espacio de trabajo. Si se supera el límite o la propia biblioteca está ocupada (Atelier201 comparte una única cuota), la respuesta será 429 rate_limited e indicará cuánto hay que esperar en Retry-After y en details.retry_after_seconds: espera ese tiempo y vuelve a intentarlo.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

El ID del sitio o su slug (la dirección antes de .atelier201.page).

Parámetros de consulta

querystringrequiredlength: 1–100 chars

Qué quieres buscar. Las búsquedas en inglés suelen ofrecer más resultados.

kindenum<string>one of: image, video

image (valor predeterminado) o video.

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

providerenum<string>one of: pixabay

La biblioteca. Por ahora, Pixabay es la única disponible y es la predeterminada.

per_pageintegerrange: 1–30

pageintegerrange: 1–50

localestringlength: ≤ 10 chars

El idioma de la consulta, por ejemplo, fr-FR.

Respuesta

application/json

Buscar fotos y vídeos de stock gratuitos

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

Solo para ver el resultado. El sitio nunca enlaza a él: importa el archivo.

data.totalintegerrequiredrange: -9007199254740991–9007199254740991

data.pageintegerrequiredrange: -9007199254740991–9007199254740991

data.attributionstringrequired

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

Cada biblioteca de stock y si se puede buscar en ella en este momento, por ejemplo, { 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 y vídeos de archivo gratuitos

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies