Skip to content
aYOUne
← Marketing API

Ratings

Singular: Rating — Base URL: https://marketing-api.ayoune.app — Access: CRUD — Machine-readable spec (JSON · YAML)

Try it now beta

Requests are proxied through the consumer-app to *.ayoune.app. Tokens stay in your browser and are forwarded per call.

Example response (recorded) sample

A real, previously recorded GET /:id response of this endpoint — not the live call above. Sensitive fields are masked.

{
  "payload": {
    "_id": "6ac712f3c0aedf1dd2f5a6a4",
    "_reviewSource": "6ac711c860f8a25b196132bb",
    "externalId": "14631385370",
    "_businessLocation": "6ac4c55fed1f2cb017939eb5",
    "approved": false,
    "author": "cadel.",
    "createdAt": "2026-10-08T03:50:11.639Z",
    "displayName": "cadel.",
    "done": true,
    "image": "https://cdn1.iconfinder.com/data/icons/user-pictures/100/unknown-64.png",
    "interestchannels": [],
    "lang": "de",
    "platform": "app-store",
    "publishedAt": "2026-10-05T17:25:25.000Z",
    "rating": "broken — whatsapp is broken because i cannot update it. heres how: one time i accidentally forgot to update my whatsapp and then it expired, which forced me to update it. but my dads account was logged jn and now i cant update it because it needs a password. plus i forgot the password on my account. please fix this bug",
    "rejected": false,
    "shares": [],
    "stars": "1",
    "type": "app-store",
    "updatedAt": "2026-10-08T03:51:38.981Z",
    "web": false
  },
  "meta": {
    "links": [
      {
        "rel": "self",
        "href": "https://marketing-api.ayoune.app/ratings/6ac712f3c0aedf1dd2f5a6a4",
        "method": "get",
        "title": "GET",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      },
      {
        "rel": "BusinessLocations",
        "title": "MODEL_BUSINESSLOCATION",
        "href": "https://api.ayoune.app/config/businesslocations/6ac4c55fed1f2cb017939eb5",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "config.businesslocations"
      },
      {
        "rel": "ReviewSources",
        "title": "MODEL_REVIEWSOURCE",
        "href": "https://api.ayoune.app/marketing/reviewsources/6ac711c860f8a25b196132bb",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "marketing.reviewsources"
      }
    ],
    "relations": [
      {
        "rel": "Consumers",
        "title": "MODEL_CONSUMER",
        "href": "https://api.ayoune.app/crm/consumers",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "crm.consumers"
      },
      {
        "rel": "Products",
        "title": "MODEL_PRODUCT",
        "href": "https://api.ayoune.app/pim/products",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "pim.products"
      },
      {
        "rel": "BusinessLocations",
        "title": "MODEL_BUSINESSLOCATION",
        "href": "https://api.ayoune.app/config/businesslocations",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "config.businesslocations"
      },
      {
        "rel": "ReviewSources",
        "title": "MODEL_REVIEWSOURCE",
        "href": "https://api.ayoune.app/marketing/reviewsources",
        "method": "get",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ],
        "right": "marketing.reviewsources"
      }
    ],
    "debugId": "6aded07f25c052497e7a94a2",
    "errors": [],
    "actions": [
      {
        "rel": "self",
        "action": "COPY",
        "title": "MODEL_RATING",
        "href": "https://api.ayoune.app/marketing/ratings/6ac712f3c0aedf1dd2f5a6a4/copy",
        "method": "post",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      },
      {
        "rel": "self",
        "action": "DELETE",
        "title": "MODEL_RATING",
        "href": "https://api.ayoune.app/marketing/ratings/6ac712f3c0aedf1dd2f5a6a4",
        "method": "delete",
        "types": [
          "application/json",
          "application/yaml",
          "text/csv"
        ]
      }
    ],
    "version": {
      "host": "2026.38.0",
      "core": "2026.388.0"
    },
    "rateLimit": {
      "limit": "10000",
      "remaining": "9193",
      "reset": "1792990581",
      "resetDate": "Mon Oct 26 2026"
    },
    "responseTime": 91.963016,
    "code": 200,
    "status": "success",
    "error": false
  }
}

Endpoints

MethodPathDescriptionRight
GET /ratings List with filters/pagination marketing.ratings.view
GET /ratings/:id Single record marketing.ratings.view
POST /ratings Create new record marketing.ratings.new
PUT /ratings Update record marketing.ratings.edit
DELETE /ratings/:id Delete record marketing.ratings.delete

SDK

import { aYOUne } from '@tolinax/ayoune';
const ay = new aYOUne('pat_your_token');

// List all
const list = await ay.marketing.ratings.find().limit(10).exec();

// Single record
const one = await ay.marketing.ratings.findById('OBJECT_ID').exec();

// Create
const created = await ay.marketing.ratings.create({ name: 'Foo' });

See also