media

Search free stock photos and videos

Searches Pixabay (free photos and videos). Nothing is stored: import the one you choose. preview_url is for looking at a result only.

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

Requires sites:read. Costs no credits and stores nothing.

Each result has its provider, its id, its size, a description, its author and a preview_url. The preview is for looking at the result only: a site never links to it. Import the one you choose, and it is copied into the site’s media.

providers says which libraries can be searched now, for example { "pixabay": "available" }. List the models gives the same before any search. Naming a library that is unavailable is refused with service_unavailable, its name in details.provider and the available ones in details.providers.

English queries return the most results. Results come from Pixabay, the only library for now; provider is always pixabay. Answers are cached for a day.

At most 30 searches and imports a minute per workspace. Above that, and when the library itself is busy (one quota for all of Atelier201), the answer is 429 rate_limited with how long to wait in Retry-After and in details.retry_after_seconds: wait that long, then try again.

Authorizations

Authorizationbearerin headerrequired

Path parameters

site_idstringrequired

The site's id, or its slug (the address before .atelier201.page).

Query parameters

querystringrequiredlength: 1–100 chars

What to look for. English gives the most results.

kindenum<string>one of: image, video

image (default) or video.

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

providerenum<string>one of: pixabay

The library. Pixabay is the only one for now, and the default.

per_pageintegerrange: 1–30

pageintegerrange: 1–50

localestringlength: ≤ 10 chars

The query's language, e.g. fr-FR.

Response

application/json

Search free stock photos and videos

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

To look at the result only. A site never links to it: import the file.

data.totalintegerrequiredrange: -9007199254740991–9007199254740991

data.pageintegerrequiredrange: -9007199254740991–9007199254740991

data.attributionstringrequired

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

Each stock library and whether it can be searched now, e.g. { 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>" }

Search free stock photos and videos

Authorizations

Path parameters

Query parameters

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies