Compose & places

GET/api/v1.1/compose/settings

Get compose settings

Pixelfed only User token

Returns

curl "https://pixelfed.social/api/v1.1/compose/settings" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/compose/settings", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const settings = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/compose/settings",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
)

settings = res.json()

use Illuminate\Support\Facades\Http;

$settings = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/compose/settings')
    ->json();

Response

{
  "allowed_media_types": ["image/jpeg", "image/jpg", "image/png", "image/gif", "video/mp4"],
  "max_caption_length": 500,
  "default_license": 1,
  "media_descriptions": false,
  "max_file_size": 15000,
  "max_media_attachments": 10,
  "max_altext_length": 1000,
  "default_scope": "public"
}

{
  "error": "Invalid permissions for this action"
}

GET/api/v1.1/compose/search/location

Search locations

Pixelfed only User token

Query parameters

qstringrequired

Returns

curl "https://pixelfed.social/api/v1.1/compose/search/location?q=Tallinn, Estonia" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/compose/search/location?q=Tallinn, Estonia", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const places = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/compose/search/location",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "q": "Tallinn, Estonia",
    },
)

places = res.json()

use Illuminate\Support\Facades\Http;

$places = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/compose/search/location', [
        'q' => 'Tallinn, Estonia',
    ])
    ->json();

Response

[{
  "id": 61244,
  "name": "Tallinn",
  "country": "Estonia",
  "url": "https://pixelfed.social/discover/places/61244/tallinn"
}]

{
  "message": "The q field is required.",
  "errors": {
    "q": ["The q field is required."]
  }
}

GET/api/v1.1/places/posts/{id}/{slug}

Get posts for a place

Pixelfed only User token Scope read

Path parameters

idstringrequired

slugstringrequired

Returns

curl "https://pixelfed.social/api/v1.1/places/posts/61244/tallinn" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/places/posts/61244/tallinn", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const place = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/places/posts/61244/tallinn",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
)

place = res.json()

use Illuminate\Support\Facades\Http;

$place = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/places/posts/61244/tallinn')
    ->json();

Response

{
  "place": {
    "id": 61244,
    "name": "Tallinn",
    "slug": "tallinn",
    "country": "Estonia",
    "lat": "59.436960",
    "long": "24.753530"
  },
  "posts": [{
    "id": "728341901556629504",
    "url": "https://pixelfed.social/p/dansup/728341901556629504",
    "content": "Golden hour at the pier",
    "created_at": "2026-09-14T17:42:10.000Z",
    "visibility": "public",
    "pf_type": "photo",
    "place": {
      "id": 61244,
      "name": "Tallinn",
      "slug": "tallinn",
      "country": "Estonia"
    },
    "media_attachments": [{
      "id": "728341067224219648",
      "type": "image",
      "url": "https://pixelfed.social/storage/m/_v2/2/pier.jpg"
    }],
    "account": {
      "id": "2",
      "username": "dansup",
      "acct": "dansup"
    }
  }]
}

{
  "error": "Record not found"
}

Pixelfed is free and open source software. Edit this page Report a docs issue