Skip to main content
GET
/
imgs
/
{image_id}
Get 1 image
curl --request GET \
  --url https://api.wesog.com/imgs/{image_id} \
  --header 'API-Key: <api-key>'
import requests

url = "https://api.wesog.com/imgs/{image_id}"

headers = {"API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'API-Key': '<api-key>'}};

fetch('https://api.wesog.com/imgs/{image_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wesog.com/imgs/{image_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"API-Key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.wesog.com/imgs/{image_id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("API-Key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.wesog.com/imgs/{image_id}")
.header("API-Key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.wesog.com/imgs/{image_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "image_id": "<string>",
  "src": "https://cdn.example.com/image/source.jpg",
  "src_path": "/data/images/source.jpg",
  "url_img_watermark": "https://cdn.example.com/image/wm.jpg",
  "url_img_thumbnail": "https://cdn.example.com/image/thumb.jpg",
  "title": "image123",
  "headline": "Sunset over the Hudson River",
  "caption": "A vibrant orange sunset reflecting on the river with the city skyline in silhouette.",
  "alt_text": "<string>",
  "ai_generated": true,
  "model_release": true,
  "property_release": true,
  "nsfw": true,
  "status": "Active",
  "date": "2024-10-19",
  "location": "123 Main St, near Central Park",
  "city": "New York",
  "country": "United States",
  "event": "Oscar awards 2024",
  "author": "Jane Doe",
  "provider": "Acme Inc.",
  "shot": "Portrait",
  "scene": "Town square",
  "technique": "Drawing",
  "medium": "Oil on canvas",
  "keywords": [
    "Tree",
    "Dog",
    "Ball",
    "Water"
  ],
  "categories": [
    "Sport",
    "Fashion",
    "Politics"
  ],
  "collections": [
    "Steet pics",
    "Exclusive"
  ],
  "height": 123,
  "width": 123,
  "n_faces": 123
}
{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}

Authorizations

API-Key
string
header
required

Query Parameters

fields
enum<string>[]

List of fields to retrieve. Example: fields=title&fields=description

Available options:
image_id,
src,
src_path,
url_img_watermark,
url_img_thumbnail,
title,
headline,
caption,
alt_text,
ai_generated,
model_release,
property_release,
nsfw,
status,
date,
location,
city,
country,
event,
author,
provider,
shot,
scene,
technique,
medium,
keywords,
categories,
collections,
height,
width,
n_faces

Response

Successful Response

image_id
string | null
src
string | null

Url of the image in high or medium resolution (used as source for the AI). Alternative to src_path; provide exactly one of the two.

Example:

"https://cdn.example.com/image/source.jpg"

src_path
string | null

Local filesystem path of the image (used as source for the AI). Alternative to src; provide exactly one of the two.

Example:

"/data/images/source.jpg"

url_img_watermark
string | null

URL of the watermarked image.

Example:

"https://cdn.example.com/image/wm.jpg"

url_img_thumbnail
string | null

URL of the thumbnail image.

Example:

"https://cdn.example.com/image/thumb.jpg"

title
string | null

A shorthand reference for the image.

Example:

"image123"

headline
string | null

Short text describing the image.

Example:

"Sunset over the Hudson River"

caption
string | null

Long text describing the image.

Example:

"A vibrant orange sunset reflecting on the river with the city skyline in silhouette."

alt_text
string | null

Text describing the visual appearance of an image (Accessibility).

ai_generated
boolean | null

Image generated by Artificial Intelligence.

model_release
boolean | null

image with model release.

property_release
boolean | null

image with property release.

nsfw
boolean | null

Image Not Safe For Work.

status
string | null

Current status of the image.

Example:

"Active"

date
string | null

Date of the image creation in year-month-day format. Capture date for photographies.

Example:

"2024-10-19"

location
string | null

A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.

Example:

"123 Main St, near Central Park"

city
string | null

Name of the country.

Example:

"New York"

country
string | null

Name of the country.

Example:

"United States"

event
string | null

Related event

Example:

"Oscar awards 2024"

author
string | null

The name of the individual or entity responsible for creating the image, such as a photographer or painter.

Example:

"Jane Doe"

provider
string | null

The identifier of the provider, which can be either a unique numeric ID or a descriptive name.

Example:

"Acme Inc."

shot
string | null

Type of photography shot.

Example:

"Portrait"

scene
string | null

Spot, place, visual location

Example:

"Town square"

technique
string | null

The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.

Example:

"Drawing"

medium
string | null

The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.

Example:

"Oil on canvas"

keywords
string[] | null

Specific tags describing the image

Example:
["Tree", "Dog", "Ball", "Water"]
categories
string[] | null

General categories of the image

Example:
["Sport", "Fashion", "Politics"]
collections
string[] | null

Collections that the image belongs to

Example:
["Steet pics", "Exclusive"]
height
integer | null

Height of the image.

width
integer | null

Width of the image.

n_faces
integer | null

Num of people faces that appears on the image.