API di Flickr
Cerca foto e video pubblici o leggi i caricamenti di un creator, con metadati per organizzare le ricerche visive.
Per i caricamenti di un creator noto usa un NSID di Flickr. Il nome visualizzato non è lo stesso identificativo.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su flickr e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 2 funzionalità
- $24 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Flickr: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $24 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca su Flickr foto o video che corrispondono a una keyword. | Normale | |
Post dell'utenteuser_posts | Elenca foto e video di un membro Flickr tramite il suo NSID in user_id. | Normale |
Cosa accetta ogni azione di API di Flickr?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $24 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca su Flickr foto o video che corrispondono a una | keyword | media_type, sort | Valori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform | |
user_postsPost dell'utente Elenca foto e video di un membro Flickr tramite il suo NSID in | user_id | author_id, media_type, sort, username | Valori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
Cosa significano i parametri search di API di Flickr?
Cerca su Flickr foto o video che corrispondono a una keyword. Ottieni titolo, link all'immagine, tag, nome e ID del fotografo, data di scatto e data di caricamento. taken_at proviene dai dati EXIF, può essere vuoto ed è diverso dalla data di caricamento. Un link non concede alcun diritto di riutilizzo.
keywordObbligatorio- Specifica il termine di ricerca per foto o video nell'azione search. Il tipo di contenuti restituiti è controllato da media_type e questo parametro non esegue ricerche esatte per nome visualizzato dell'autore.
media_typeFacoltativo- Filtra il tipo di contenuti con i valori consentiti: photos (solo foto), videos (solo video) o all (tutti i contenuti). Il valore predefinito è photos in search e all in user_posts. Questo parametro controlla il filtro della query e non determina se vengono scaricati i file sorgente originali.Flickr: il tipo di media è distinto dalla licenza dei contenuti — Flickr separa esplicitamente le definizioni dei tipi di media dalle classificazioni delle licenze. Al momento EveryInfra fornisce il parametro `media_type` ma non espone i parametri ufficiali sulle licenze. Trovare una foto o un video tramite la ricerca non concede diritti d'uso su quel contenuto. · Verificato
sortFacoltativo- Ordina foto e video in search (predefinito relevance) e in user_posts (predefinito date-posted-desc). I valori supportati includono relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc e date-taken-asc. La data di caricamento (date-posted) e la data di scatto (date-taken) sono attributi distinti e non sono intercambiabili.Flickr: ordinare per data di scatto o per data di pubblicazione — La documentazione di Flickr distingue l'ordinamento per data di scatto da quello per data di pubblicazione. Questo chiarisce la semantica temporale, ma i valori predefiniti, i parametri supportati e i limiti massimi di risultati di questo endpoint sono quelli documentati da EveryInfra e non replicano tutte le funzionalità dell'API ufficiale. · Verificato
Cosa significano i parametri user_posts di API di Flickr?
Elenca foto e video di un membro Flickr tramite il suo NSID in user_id. Ottieni titoli, link alle immagini, tag, data di scatto e data di caricamento. Passa l'NSID preso dall'author_id di un risultato di ricerca, non un nome visualizzato. Gli album privati non sono inclusi.
user_idObbligatorio- Specifica l'NSID dell'utente Flickr di destinazione, ad esempio 12345678@N04, che puoi ricavare dal campo author_id dei risultati di ricerca. Non accetta nomi visualizzati, alias personalizzati del profilo né URL completi del profilo.Flickr: cosa significa l'NSID dell'utente — La documentazione di Flickr definisce `user_id` come l'NSID dell'utente, distinto dal nome visualizzato o dal percorso URL personalizzato del profilo. Questa definizione non implica che EveryInfra possa accedere alle foto private di un utente. · Verificato
media_typeFacoltativo- Filtra il tipo di contenuti con i valori consentiti: photos (solo foto), videos (solo video) o all (tutti i contenuti). Il valore predefinito è photos in search e all in user_posts. Questo parametro controlla il filtro della query e non determina se vengono scaricati i file sorgente originali.
sortFacoltativo- Ordina foto e video in search (predefinito relevance) e in user_posts (predefinito date-posted-desc). I valori supportati includono relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc e date-taken-asc. La data di caricamento (date-posted) e la data di scatto (date-taken) sono attributi distinti e non sono intercambiabili.
usernameFacoltativo- Funge da alias di compatibilità per user_id in user_posts. Richiede comunque un NSID Flickr valido anziché un nome visualizzato leggibile, e le richieste pubbliche a user_posts devono comunque includere il parametro obbligatorio user_id.
Come usare l'API di Flickr
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"flickr","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Flickr
Cosa posso ottenere con l'API di Flickr?
Imposta platform su flickr. Il catalogo attuale elenca ricerca e post dell'utente. Questi nomi di azione identificano oggetti o viste diversi di Flickr; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Flickr?
Specifica il termine di ricerca per foto o video nell'azione search. Il tipo di contenuti restituiti è controllato da media_type e questo parametro non esegue ricerche esatte per nome visualizzato dell'autore. Invialo come keyword all'interno di params.
Quali campi può restituire search di Flickr?
Il suo schema dichiarato include title, image_url, media_type e author_name. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Flickr rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.