API DeviantArt Dettagli
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Recupera il profilo di un artista DeviantArt tramite username: nome visualizzato, bio, avatar, link al profilo ed eventuali email di contatto pubblicate con i relativi domini. Le sue opere si ottengono con gallery.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su deviantart e action impostato su profile. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
DeviantArt Details legge il profilo pubblico di un artista a partire dal suo username e restituisce un unico record: l'handle, il display_name, la bio scritta dall'artista, l'avatar, il link del profilo e, se l'artista li ha pubblicati, gli indirizzi di contatto in emails con i relativi domini in email_domains. Risponde alla domanda su chi c'è dietro un account DeviantArt e su come descrive il proprio lavoro, per editori e brand che verificano il profilo pubblico di un artista prima di una commissione o di una licenza, e per ricercatori che studiano le community di creator.
display_name può differire da username, e bio può contenere interruzioni di riga ed emoji. emails elenca gli indirizzi esattamente come pubblicati e viene omesso del tutto quando non ce ne sono. I link agli avatar possono essere URL di CDN con dimensioni specifiche che possono scadere, quindi scarica l'immagine se ti serve conservarla.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint DeviantArt Dettagli di EveryInfra (deviantart/profile).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su deviantart e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
- username: Lo username dell'artista DeviantArt così come appare dopo deviantart.com/ nell'URL del profilo, senza simbolo @, nome di dominio o percorso.
- Restituisce un oggetto. Campi principali: username, display_name, bio, avatar_url, url, emails, email_domains.
- Esempio di corpo della richiesta:
{
"platform": "deviantart",
"action": "profile",
"params": {
"username": "pixelbypixel"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | deviantart | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | profile | Identificativo della funzionalità, valore fisso. |
username | body.params | string | Sì | - | Lo username dell'artista DeviantArt così come appare dopo deviantart.com/ nell'URL del profilo, senza simbolo @, nome di dominio o percorso. gallery restituisce le opere dell'artista e profile ne restituisce il profilo pubblico. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "deviantart",
"action": "profile",
"params": {
"username": "pixelbypixel"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "deviantart", "action": "profile", "results": { "username": "pixelbypixel", "display_name": "pixelbypixel", "avatar_url": "https://a.deviantart.net/•••", "url": "https://www.deviantart.com/pixelbypixel", "platform": "deviantart" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
username | Username (@handle). |
display_name | Nome visualizzato; può essere diverso da username. |
bio | Bio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji. |
avatar_url | Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere. |
url | Link al record sulla piattaforma. |
emails | Indirizzi email di contatto (un record può averne più di uno), passati così come sono e senza duplicati. |
email_domains | Mantiene il significato attribuito dalla piattaforma |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Cosa devo passare come username?
#Solo lo username dell'artista, ad esempio pixelbypixel, senza @, dominio o percorso. Puoi ricavarlo dal link del profilo dell'artista, oppure prendere lo username dell'autore dai risultati di DeviantArt Search o Popular. Il nome visualizzato non lo sostituisce, perché può differire dallo username.
DeviantArt Details restituisce le opere dell'artista?
#No. Restituisce solo il profilo: handle, nome visualizzato, bio, avatar, link del profilo ed eventuali indirizzi di contatto pubblicati. Per elencare le opere dell'artista, passa lo stesso username a DeviantArt Gallery, che può filtrarle per categoria, oppure trova opere su un soggetto tra tutti gli artisti con DeviantArt Search.
Ogni profilo include un indirizzo email?
#No. emails compare solo quando l'artista ha reso pubblici degli indirizzi di contatto, e il campo è assente, non vuoto, quando non ce ne sono. email_domains elenca i domini di quegli indirizzi, il che ti permette di raggruppare i profili per organizzazione o provider email senza salvare gli indirizzi completi.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.