Posts

Actions available on posts.


List

Retrieve a list of matching posts.

Request

  • url: /admin/api/v2/feeds/{feedId}/posts
  • method: GET
  • parameters:

    • feedId: required, string, exact match
    • id: optional, string, exact match
    • name: optional, string, partial match

Response

posts.json
{
  "data": [
    {
      "id": "7GZEJPE2",
      "name": "blanditiis",
      "url": "/temporibus/non-corporis-eos-eius-non-perspiciatis-iusto-ut",
      "absolute_url": "https://your-domain.givecloud.co/temporibus/non-corporis-eos-eius-non-perspiciatis-iusto-ut",
      "summary": "Velit qui rem quisquam. Assumenda sunt occaecati accusamus quam at optio.",
      "feature_image": {
        "id": "MKYEL8EW",
        "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/id-quas-qui-fuga.jpg",
        "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/id-quas-qui-fuga_300x_cropped_top.jpg",
        "is_audio": false,
        "is_image": true,
        "is_video": false,
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      },
      "alt_image": {
        "id": "P59EKZDK",
        "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/nostrum-ex-sint-nihil.jpg",
        "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/nostrum-ex-sint-nihil_300x_cropped_top.jpg",
        "is_audio": false,
        "is_image": true,
        "is_video": false,
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      },
      "tags": [
        "omnis et",
        "est"
      ],
      "body": "Quod ullam totam ab qui rem aspernatur inventore. Voluptate rem est doloribus labore quas laborum. Et ut molestiae harum doloremque. Repellendus molestias sint alias dolores sit fuga consequatur quisquam. Fugit est autem repudiandae nam ipsam consequuntur repudiandae.\n\nIn odit eos vitae. Voluptatem dolores modi deleniti velit voluptatibus eveniet sed. Corrupti saepe aliquid enim nostrum dolor doloremque.\n\nMolestiae fugiat qui cupiditate id aut. Repellendus nesciunt totam dolorem qui ad cum. Eum aliquam laboriosam debitis sapiente ut est rerum.",
      "published_on": "2020-06-01T11:00:00Z",
      "expires_on": "",
      "post_type": {
        "id": "7GZEJPE2",
        "url_slug": "temporibus",
        "name": "temporibus",
        "sysname": "blog",
        "template_suffix": null,
        "default_template_suffix": null,
        "rss_link": "https://your-domain.givecloud.co/feed?i=1",
        "rss_copyright": "eaque",
        "rss_description": "Non eaque esse error laborum. Nihil aut enim repellat consequatur consequatur.",
        "imagepath": null,
        "show_social_share_links": 0,
        "photo": {
          "id": "7GZEJPE2",
          "full": "https://cdn.givecloud.co/s/files/1/0000/0001//",
          "thumb": "data:image/gif;base64,R0lGODlhAQABAIAAAMLCwgAAACH5BAAAAAAALAAAAAABAAEAAAICRAEAOw==",
          "is_audio": false,
          "is_image": false,
          "is_video": false,
          "created_at": "2020-06-01T12:00:00Z",
          "updated_at": "2020-06-01T12:00:00Z"
        },
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      }
    },
    {
      "id": "P59EKZDK",
      "name": "aperiam",
      "url": "/temporibus/quia-quaerat-mollitia-est-quis-et-et",
      "absolute_url": "https://your-domain.givecloud.co/temporibus/quia-quaerat-mollitia-est-quis-et-et",
      "summary": "Reiciendis laudantium neque rerum dolores quos libero dicta. Rerum molestiae molestiae soluta sed veniam. Magnam vero aut voluptatem labore aspernatur voluptatem. Quas quis nihil dolorem. Molestiae laboriosam rerum quia.",
      "feature_image": {
        "id": "NP7EN4EG",
        "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/nisi-ut-facilis-velit.jpg",
        "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/nisi-ut-facilis-velit_300x_cropped_top.jpg",
        "is_audio": false,
        "is_image": true,
        "is_video": false,
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      },
      "alt_image": {
        "id": "KJLEMLD8",
        "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/sit-accusantium-consectetur.jpg",
        "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/sit-accusantium-consectetur_300x_cropped_top.jpg",
        "is_audio": false,
        "is_image": true,
        "is_video": false,
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      },
      "tags": [
        "error qui",
        "dolorum praesentium",
        "expedita saepe aperiam"
      ],
      "body": "Et facere voluptatem deleniti voluptates sed. Voluptate atque adipisci quia magni quam consequatur aliquam. Et voluptatum deleniti quis.\n\nAdipisci et numquam architecto possimus dolores et fugit. Cum cupiditate ea similique et. Quo qui consectetur in et.\n\nQuasi id sit impedit ratione atque quidem. Sed odit labore fugiat amet. At autem quis adipisci expedita omnis. Mollitia possimus sed laudantium ut.",
      "published_on": "2020-06-01T11:00:00Z",
      "expires_on": "",
      "post_type": {
        "id": "7GZEJPE2",
        "url_slug": "temporibus",
        "name": "temporibus",
        "sysname": "blog",
        "template_suffix": null,
        "default_template_suffix": null,
        "rss_link": "https://your-domain.givecloud.co/feed?i=1",
        "rss_copyright": "eaque",
        "rss_description": "Non eaque esse error laborum. Nihil aut enim repellat consequatur consequatur.",
        "imagepath": null,
        "show_social_share_links": 0,
        "photo": {
          "id": "7GZEJPE2",
          "full": "https://cdn.givecloud.co/s/files/1/0000/0001//",
          "thumb": "data:image/gif;base64,R0lGODlhAQABAIAAAMLCwgAAACH5BAAAAAAALAAAAAABAAEAAAICRAEAOw==",
          "is_audio": false,
          "is_image": false,
          "is_video": false,
          "created_at": "2020-06-01T12:00:00Z",
          "updated_at": "2020-06-01T12:00:00Z"
        },
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      }
    },
    {
      "id": "MKYEL8EW",
      "name": "aut quo nulla earum et",
      "url": "/temporibus/reprehenderit-id-alias-nobis-fugit-praesentium-est",
      "absolute_url": "https://your-domain.givecloud.co/temporibus/reprehenderit-id-alias-nobis-fugit-praesentium-est",
      "summary": "Officiis error possimus delectus enim. Voluptas minus vero temporibus est eveniet.",
      "feature_image": {
        "id": "Z8NER6EK",
        "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/rerum-dolores-et-id.jpg",
        "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/rerum-dolores-et-id_300x_cropped_top.jpg",
        "is_audio": false,
        "is_image": true,
        "is_video": false,
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      },
      "alt_image": {
        "id": "LGKDPYER",
        "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/mollitia-quia-odit.jpg",
        "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/mollitia-quia-odit_300x_cropped_top.jpg",
        "is_audio": false,
        "is_image": true,
        "is_video": false,
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      },
      "tags": [
        "repellendus deleniti"
      ],
      "body": "Non iure est et beatae tempora pariatur quae ut. Et adipisci earum omnis molestiae. Perspiciatis recusandae excepturi aut omnis sit dicta fugiat.\n\nMolestias qui quam deleniti ut ut sapiente. Consequatur non voluptas autem quas quaerat optio dolorem repudiandae. In dolorum impedit et enim.\n\nExcepturi qui accusamus quisquam eum. Earum aut ab et quibusdam non. Ipsa earum adipisci et nemo.",
      "published_on": "2020-06-01T11:00:00Z",
      "expires_on": "",
      "post_type": {
        "id": "7GZEJPE2",
        "url_slug": "temporibus",
        "name": "temporibus",
        "sysname": "blog",
        "template_suffix": null,
        "default_template_suffix": null,
        "rss_link": "https://your-domain.givecloud.co/feed?i=1",
        "rss_copyright": "eaque",
        "rss_description": "Non eaque esse error laborum. Nihil aut enim repellat consequatur consequatur.",
        "imagepath": null,
        "show_social_share_links": 0,
        "photo": {
          "id": "7GZEJPE2",
          "full": "https://cdn.givecloud.co/s/files/1/0000/0001//",
          "thumb": "data:image/gif;base64,R0lGODlhAQABAIAAAMLCwgAAACH5BAAAAAAALAAAAAABAAEAAAICRAEAOw==",
          "is_audio": false,
          "is_image": false,
          "is_video": false,
          "created_at": "2020-06-01T12:00:00Z",
          "updated_at": "2020-06-01T12:00:00Z"
        },
        "created_at": "2020-06-01T12:00:00Z",
        "updated_at": "2020-06-01T12:00:00Z"
      }
    }
  ],
  "links": {
    "first": "https://your-domain.givecloud.co/admin/api/v2/feeds/7GZEJPE2/posts?page=1",
    "last": "https://your-domain.givecloud.co/admin/api/v2/feeds/7GZEJPE2/posts?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "active": false
      },
      {
        "url": "https://your-domain.givecloud.co/admin/api/v2/feeds/7GZEJPE2/posts?page=1",
        "label": 1,
        "active": true
      },
      {
        "url": null,
        "label": "Next »",
        "active": false
      }
    ],
    "path": "https://your-domain.givecloud.co/admin/api/v2/feeds/7GZEJPE2/posts",
    "per_page": 15,
    "to": 3,
    "total": 3
  }
}

Get

Retrieve the first matching post. This returns a 404 if there is no matching post found.

Request

  • url: /admin/api/v2/feeds/{feedId}/posts/{id}
  • method: GET
  • parameters:

    • feedId: required, string, exact match
    • id: string, exact match

Response

post.json
{
  "id": "P59EKZDK",
  "name": "aperiam",
  "url": "/temporibus/quia-quaerat-mollitia-est-quis-et-et",
  "absolute_url": "https://your-domain.givecloud.co/temporibus/quia-quaerat-mollitia-est-quis-et-et",
  "summary": "Reiciendis laudantium neque rerum dolores quos libero dicta. Rerum molestiae molestiae soluta sed veniam. Magnam vero aut voluptatem labore aspernatur voluptatem. Quas quis nihil dolorem. Molestiae laboriosam rerum quia.",
  "feature_image": {
    "id": "NP7EN4EG",
    "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/nisi-ut-facilis-velit.jpg",
    "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/nisi-ut-facilis-velit_300x_cropped_top.jpg",
    "is_audio": false,
    "is_image": true,
    "is_video": false,
    "created_at": "2020-06-01T12:00:00Z",
    "updated_at": "2020-06-01T12:00:00Z"
  },
  "alt_image": {
    "id": "KJLEMLD8",
    "full": "https://cdn.givecloud.co/s/files/1/0000/0001/files/sit-accusantium-consectetur.jpg",
    "thumb": "https://cdn.givecloud.co/s/files/2/0000/0001/files/sit-accusantium-consectetur_300x_cropped_top.jpg",
    "is_audio": false,
    "is_image": true,
    "is_video": false,
    "created_at": "2020-06-01T12:00:00Z",
    "updated_at": "2020-06-01T12:00:00Z"
  },
  "tags": [
    "error qui",
    "dolorum praesentium",
    "expedita saepe aperiam"
  ],
  "body": "Et facere voluptatem deleniti voluptates sed. Voluptate atque adipisci quia magni quam consequatur aliquam. Et voluptatum deleniti quis.\n\nAdipisci et numquam architecto possimus dolores et fugit. Cum cupiditate ea similique et. Quo qui consectetur in et.\n\nQuasi id sit impedit ratione atque quidem. Sed odit labore fugiat amet. At autem quis adipisci expedita omnis. Mollitia possimus sed laudantium ut.",
  "published_on": "2020-06-01T11:00:00Z",
  "expires_on": "",
  "post_type": {
    "id": "7GZEJPE2",
    "url_slug": "temporibus",
    "name": "temporibus",
    "sysname": "blog",
    "template_suffix": null,
    "default_template_suffix": null,
    "rss_link": "https://your-domain.givecloud.co/feed?i=1",
    "rss_copyright": "eaque",
    "rss_description": "Non eaque esse error laborum. Nihil aut enim repellat consequatur consequatur.",
    "imagepath": null,
    "show_social_share_links": 0,
    "photo": {
      "id": "7GZEJPE2",
      "full": "https://cdn.givecloud.co/s/files/1/0000/0001//",
      "thumb": "data:image/gif;base64,R0lGODlhAQABAIAAAMLCwgAAACH5BAAAAAAALAAAAAABAAEAAAICRAEAOw==",
      "is_audio": false,
      "is_image": false,
      "is_video": false,
      "created_at": "2020-06-01T12:00:00Z",
      "updated_at": "2020-06-01T12:00:00Z"
    },
    "created_at": "2020-06-01T12:00:00Z",
    "updated_at": "2020-06-01T12:00:00Z"
  }
}