media

Kostenlose Stockfotos und -videos suchen

Durchsucht Pixabay nach kostenlosen Fotos und Videos. Es wird nichts gespeichert: Importiere das gewünschte Bild oder Video. preview_url dient nur zur Vorschau eines Ergebnisses.

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>"
}

Erfordert sites:read. Kostet keine Credits und speichert nichts.

Jedes Ergebnis enthält provider, id, die Größe, eine Beschreibung, den Namen des Urhebers und eine preview_url. Die Vorschau dient nur dazu, das Ergebnis anzusehen. Ein Standort verlinkt niemals darauf. Importiere das gewünschte Ergebnis. Es wird dann in die Medien des Standorts kopiert.

providers gibt an, welche Bibliotheken derzeit durchsucht werden können, zum Beispiel { "pixabay": "available" }. Die Modelle auflisten zeigt dasselbe bereits vor einer Suche an. Wird eine nicht verfügbare Bibliothek angegeben, wird die Anfrage mit service_unavailable abgelehnt. details.provider enthält ihren Namen und details.providers die verfügbaren Bibliotheken.

Mit englischen Suchanfragen erhältst du die meisten Ergebnisse. Derzeit stammen alle Ergebnisse von Pixabay, der einzigen verfügbaren Bibliothek. provider ist immer pixabay. Antworten werden einen Tag lang zwischengespeichert.

Pro Workspace sind höchstens 30 Suchen und Importe pro Minute möglich. Bei Überschreitung oder wenn die Bibliothek selbst ausgelastet ist (ein gemeinsames Kontingent für ganz Atelier201), lautet die Antwort 429 rate_limited. Die Wartezeit steht in Retry-After und details.retry_after_seconds. Warte entsprechend lange und versuche es dann erneut.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Query-Parameter

querystringrequiredlength: 1–100 chars

Wonach gesucht werden soll. Auf Englisch gibt es die meisten Ergebnisse.

kindenum<string>one of: image, video

image (Standard) oder video.

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

providerenum<string>one of: pixabay

Die Bibliothek. Vorerst ist Pixabay die einzige Option und die Standardeinstellung.

per_pageintegerrange: 1–30

pageintegerrange: 1–50

localestringlength: ≤ 10 chars

Die Sprache der Suchanfrage, z. B. fr-FR.

Antwort

application/json

Kostenlose Stockfotos und -videos suchen

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

Nur zur Vorschau des Ergebnisses. Eine Website verlinkt nie darauf: Importiere die Datei.

data.totalintegerrequiredrange: -9007199254740991–9007199254740991

data.pageintegerrequiredrange: -9007199254740991–9007199254740991

data.attributionstringrequired

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

Jede Stock-Bibliothek und ob sie derzeit durchsucht werden kann, z. B. { 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>" }

Kostenlose Stockfotos und -videos suchen

Autorisierung

Pfadparameter

Query-Parameter

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies