media

Cercare foto e video stock gratuiti

Cerca su Pixabay (foto e video gratuiti). Non viene archiviato nulla: importa il risultato che scegli. preview_url serve solo per visualizzare un risultato.

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

Richiede sites:read. Non costa crediti e non salva nulla.

Ogni risultato include provider, id, dimensioni, descrizione, autore e preview_url. L’anteprima serve solo a consultare il risultato: il sito non vi rimanda mai. Importa il risultato scelto per copiarlo nei contenuti multimediali del sito.

providers indica quali librerie sono disponibili per la ricerca, ad esempio { "pixabay": "available" }. Elencare i modelli fornisce le stesse informazioni prima di avviare una ricerca. Se indichi una libreria non disponibile, la richiesta viene rifiutata con service_unavailable; il suo nome è in details.provider e le librerie disponibili sono in details.providers.

Le query in inglese restituiscono più risultati. Per ora i risultati provengono solo da Pixabay, quindi provider è sempre pixabay. Le risposte vengono memorizzate nella cache per un giorno.

Il limite è di 30 ricerche e importazioni al minuto per workspace. Se lo superi o se la libreria è occupata (la quota è condivisa da tutti gli utenti di Atelier201), la risposta è 429 rate_limited e indica quanto attendere in Retry-After e in details.retry_after_seconds: aspetta il tempo indicato, poi riprova.

Autorizzazioni

Authorizationbearerin headerrequired

Parametri di percorso

site_idstringrequired

L'ID del sito o il suo slug (l'indirizzo prima di .atelier201.page).

Parametri di query

querystringrequiredlength: 1–100 chars

Cosa cercare. Le ricerche in inglese restituiscono più risultati.

kindenum<string>one of: image, video

image (predefinito) o video.

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

providerenum<string>one of: pixabay

La libreria. Per ora è disponibile solo Pixabay, che è anche quella predefinita.

per_pageintegerrange: 1–30

pageintegerrange: 1–50

localestringlength: ≤ 10 chars

La lingua della query, ad esempio fr-FR.

Risposta

application/json

Cerca foto e video stock gratuiti

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 solo per visualizzare il risultato. Un sito non vi crea collegamenti: importa il file.

data.totalintegerrequiredrange: -9007199254740991–9007199254740991

data.pageintegerrequiredrange: -9007199254740991–9007199254740991

data.attributionstringrequired

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

Ogni libreria stock e la possibilità di cercarvi al momento, ad esempio { 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>" }

Cercare foto e video stock gratuiti

Autorizzazioni

Parametri di percorso

Parametri di query

Risposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookie