Upload an image and get its URL

Uploads an image to the CDN and returns its public URL, ready to be passed as media when you publish an update.

Give the image in one of two ways, never both:

  • source_url - the address of an image already online, which we download. This is the one to use for a real photo.
  • content_base64 - the image as text, for small images only. A real photo is hundreds of thousands of characters, and an assistant cannot retype them without a slip; one wrong character is a broken image on your listing.

Neither way needs a binary file, which is what makes this callable by an assistant connected through MCP: an assistant fills request fields with text.

Any common photo format works - JPEG, PNG, WebP and the HEIC an iPhone shoots: we convert it to JPEG, turn it the right way up and shrink it if it is huge. It must be at least 250x250 pixels. A data: prefix on the base64 is accepted and ignored. A source_url must be reachable from the internet: a link only your browser can open, such as a private Drive file, will not work.

The URL you get back is good for one update: publishing hands the image to Google, which keeps its own copy, and ours is dropped. For a second update, upload again.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Business id path parameter (required).

string
required

Location id path parameter (required).

Body Params

An image to put on the CDN, passed in one of the two ways a text request can carry.

  • source_url: the address of an image already online, which we download. This is the
    right way for a real photo.
  • content_base64: the image written out as text. Fine for small images, not for a real
    photo: that is hundreds of thousands of characters, and one wrong character is a broken
    image on your listing.

Pass exactly one of the two: with both, there would be no telling which one wins.

length between 3 and 200

Name of the file, extension included: it decides the format. JPEG, PNG, WebP or HEIC - whatever it is, we convert it to JPEG. Required with content_base64; with source_url it is taken from the link when you leave it out.

Public URL of the image: we download it ourselves. Use this one for real photos. It must be reachable from the internet over http or https - a link that only your browser can open, like a private Drive file, will not work.

The image encoded in base64, for small images. A data: prefix, if present, is ignored. Up to 5 MB once decoded. For a real photo prefer source_url: an assistant cannot retype hundreds of thousands of characters without a slip, and one wrong character is a broken image on your listing.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json