Sosyabot Docs

English

Türkçe

English

Türkçe

Appearance

Stock image search ​

When you don't have your own picture, search for a free stock photo right inside Sosyabot and drop it into your library or post.

Why use it ​

You don't need to leave Sosyabot or hunt for images elsewhere. Type what you want, pick a photo, and it's ready to use in seconds.

Step by step ​

Open stock search

Look for the photo search option when you're adding an image to a post or to your library, then click it to open the search box.

Type a keyword

Type a word for the picture you want, like "coffee" or "beach", then press Enter. A grid of free photos appears.

Pick a photo

Browse the results and click the photo you like best.

Add it

Click to add the photo. Sosyabot saves it to your library so you can use it in your post right away.

TIP

Try a few different keywords if the first results aren't quite right. Shorter, simpler words usually find more photos.

Good to know ​

  • The photos come from free stock providers (Unsplash, Pexels, Pixabay) and are royalty-free.
  • You can search for photos and, where available, videos.
  • Once you add a photo, it lives in your library just like a picture you uploaded yourself.
  • If the search box is empty or no providers show up, an admin may still need to turn the photo sources on.

Library

Watermarks

Composer Overview

For developers

Stock search queries configured external providers and imports a result into the Library with one click.

GET  /api/v1/search-media-online/available-sources    list enabled providers
POST /api/v1/search-media-online                      run a search

Providers are toggled per instance under Admin OAuth Credentials (the online-media-search page). Each provider needs its API key configured before it appears in available-sources.

Search request:

json
{
  "query": "cats",
  "source": "unsplash",
  "page": 1,
  "perPage": 20,
  "type": "photo"
}

Selecting a result calls POST /api/v1/files/download with the provider's hosted URL. Sosyabot fetches the asset, persists it via the same path as a normal upload, and returns the new file ID.