OCTO Specification v2.0

Partner with Istanbul's Premier Photography Studio

Automate your bookings, access real-time availability, and get dynamic pricing with our fully OCTO-compliant B2B API. Built for OTAs, concierges, and travel agencies.

Request API Key Read the Docs

100% Standardized

Built on the global OCTO standard used by Viator and GetYourGuide.

Real-time Data

Live availability and dynamic time surcharges synced instantly.

Developer Friendly

RESTful endpoints with JSON responses and Bearer token auth.

Authentication

All API requests must be authenticated using a Bearer token in the Authorization header. To get your unique API key, click the Request API Key button.

HeaderAuthorization: Bearer YOUR_API_KEY

curl -X GET "https://istanbulportrait.com/api/octo/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Core Endpoints

GET/api/octo/products

Returns a list of all active photography packages, including descriptions, inclusions, gallery images, and base pricing details.

Localization Support: This endpoint fully supports the BCP 47 standard. You can pass an Accept-Language header (e.g., es, ru, tr, ar) to receive localized package titles, descriptions, and features.

Example Response

[
  {
    "id": "package-uuid",
    "internalName": "Surprise Rooftop Proposal",
    "title": "Surprise Rooftop Marriage Proposal",
    "durationMinutesFrom": 120,
    "durationMinutesTo": 120,
    "deliveryMethods": ["TICKET"],
    "options": [
      {
        "id": "standard",
        "availabilityLocalStartTimes": [
          "06:00", "06:30", "07:00", "07:30"
        ],
        "pricingFrom": [{
          "retail": 30000,
          "net": 27000,
          "currency": "EUR"
        }]
      }
    ]
  }
]

Ready to start building?

Get your API key today and start offering Istanbul's best photography experiences directly to your customers.