Service Guides for PublicationIQ

Investigate use cases. Find sample scenarios. Learn how your applications can best use PublicationIQ.

Get Publications by Specified Title Attributes

The Get Publications by Specified Title Attributes endpoint allows you to search for publications by publication title name, subject, isxn or publisher.

To Search for a Publication by Title Name (example):

Gather the following information for the request:

  • The EBSCO customer profile in the form of customerid.groupid.profileid.
  • The search field. In this case, it is the title name.
  • The page offset.
  • The maximum number of results to return in the response.
  • Specify if the search is required to include facet information.
  • Specify the order by. In this case, is it by relevance.
  • Specify the search type. In this case, it is any.

Request

https://sandbox.ebsco.io/pf/pfaccount/PROFILE/publications?search=bmx&offset=1&count=2&orderby=relevance&searchfield=titlename&includefacets=true&searchtype=any

Response

200 OK

{
  "SearchRequestGet": {
    "RequestParams": {
      "sessionId": null,
      "customerId": 1123
    },
    "SearchCriteriaWithActions": null
  },
  "Facets": {
    "Subjects": [
      {
        "SubjectName": "Bicycles and Cycling",
        "count": 5,
        "id": "30321",
        "parentId": "30210"
      },
      {
        "SubjectName": "BIOGRAPHY & AUTOBIOGRAPHY / Literary Figures",
        "count": 1,
        "id": "4959",
        "parentId": null
      },
      {
        "SubjectName": "BIOGRAPHY & AUTOBIOGRAPHY / Personal Memoirs",
        "count": 1,
        "id": "6951",
        "parentId": null
      },
      {
        "SubjectName": "Cycling",
        "count": 5,
        "id": "31067",
        "parentId": null
      },
      {
        "SubjectName": "FICTION / Crime",
        "count": 1,
        "id": "8076",
        "parentId": null
      },
      {
        "SubjectName": "FICTION / Mystery & Detective / Hard-Boiled",
        "count": 1,
        "id": "7551",
        "parentId": null
      },
      {
        "SubjectName": "FICTION / Mystery & Detective / Police Procedural",
        "count": 1,
        "id": "8294",
        "parentId": null
      },
      {
        "SubjectName": "FICTION / Short Stories (single author)",
        "count": 1,
        "id": "8067",
        "parentId": null
      },
      {
        "SubjectName": "FICTION / Thrillers / General",
        "count": 1,
        "id": "8061",
        "parentId": null
      },
      {
        "SubjectName": "Geography. Anthropology. Recreation",
        "count": 6,
        "id": "26212",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE FICTION / Comics & Graphic Novels / General",
        "count": 1,
        "id": "7499",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE FICTION / General",
        "count": 2,
        "id": "5779",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE NONFICTION / Biography & Autobiography / Sports & Recreation",
        "count": 1,
        "id": "5935",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE NONFICTION / Sports & Recreation / Cycling",
        "count": 10,
        "id": "6913",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE NONFICTION / Sports & Recreation / Extreme Sports",
        "count": 6,
        "id": "7799",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE NONFICTION / Sports & Recreation / General",
        "count": 3,
        "id": "6470",
        "parentId": null
      },
      {
        "SubjectName": "JUVENILE NONFICTION / Sports & Recreation / Motor Sports",
        "count": 2,
        "id": "7664",
        "parentId": null
      },
      {
        "SubjectName": "Outdoor life.  Outdoor recreation",
        "count": 2,
        "id": "26852",
        "parentId": "26753"
      },
      {
        "SubjectName": "Recreation, Leisure and Sports",
        "count": 7,
        "id": "30210",
        "parentId": null
      },
      {
        "SubjectName": "Recreation.  Leisure",
        "count": 6,
        "id": "26753",
        "parentId": "26212"
      },
      {
        "SubjectName": "Sports",
        "count": 4,
        "id": "26856",
        "parentId": "26753"
      },
      {
        "SubjectName": "Sports",
        "count": 2,
        "id": "35438",
        "parentId": null
      },
      {
        "SubjectName": "SPORTS & RECREATION / Cycling",
        "count": 3,
        "id": "6197",
        "parentId": null
      },
      {
        "SubjectName": "Sports and Games",
        "count": 2,
        "id": "30320",
        "parentId": "30210"
      },
      {
        "SubjectName": "TECHNOLOGY & ENGINEERING / Engineering (General)",
        "count": 1,
        "id": "5442",
        "parentId": null
      }
    ],
    "ResourceTypes": [
      {
        "ResourceTypes": "book",
        "count": 31
      },
      {
        "ResourceTypes": "journal",
        "count": 3
      }
    ],
    "Packages": [
      {
        "id": "159",
        "Package": "Australia/New Zealand Reference Centre",
        "count": 3
      },
      {
        "id": "3629",
        "Package": "Book Collection Nonfiction: Elementary School Edition",
        "count": 3
      },
      {
        "id": "3637",
        "Package": "Book Collection Nonfiction: High School Edition",
        "count": 1
      },
      {
        "id": "3636",
        "Package": "Book Collection Nonfiction: Middle School Edition",
        "count": 5
      },
      {
        "id": "843",
        "Package": "Book Collection: Nonfiction",
        "count": 5
      },
      {
        "id": "191",
        "Package": "Canadian Reference Centre",
        "count": 3
      },
      {
        "id": "9625",
        "Package": "eBook Canadian Collection (EBSCOhost)",
        "count": 1
      },
      {
        "id": "9622",
        "Package": "eBook K-8 Collection (EBSCOhost)",
        "count": 4
      },
      {
        "id": "9626",
        "Package": "eBook Public Library Collection (EBSCOhost) – North America",
        "count": 6
      },
      {
        "id": "9621",
        "Package": "eBook Public Library Collection (EBSCOhost) – Worldwide",
        "count": 5
      },
      {
        "id": "3950",
        "Package": "EBSCO MegaFILE",
        "count": 3
      },
      {
        "id": "4337",
        "Package": "MAS Complete",
        "count": 3
      },
      {
        "id": "196",
        "Package": "MAS Ultra - School Edition",
        "count": 3
      },
      {
        "id": "4243",
        "Package": "MasterFILE Complete",
        "count": 3
      },
      {
        "id": "172",
        "Package": "MasterFILE Premier",
        "count": 3
      },
      {
        "id": "180",
        "Package": "Middle Search Plus",
        "count": 3
      },
      {
        "id": "1861142",
        "Package": "MyiLibrary",
        "count": 15
      },
      {
        "id": "1887786",
        "Package": "ProQuest Ebook Central",
        "count": 13
      },
      {
        "id": "195",
        "Package": "UK & Ireland Reference Centre",
        "count": 1
      }
    ],
    "AlphaMenus": [
      {
        "AlphaMenu": "B",
        "count": 21
      },
      {
        "AlphaMenu": "BM",
        "count": 21
      },
      {
        "AlphaMenu": "D",
        "count": 2
      },
      {
        "AlphaMenu": "DA",
        "count": 1
      },
      {
        "AlphaMenu": "DO",
        "count": 1
      },
      {
        "AlphaMenu": "E",
        "count": 3
      },
      {
        "AlphaMenu": "EX",
        "count": 3
      },
      {
        "AlphaMenu": "F",
        "count": 1
      },
      {
        "AlphaMenu": "FR",
        "count": 1
      },
      {
        "AlphaMenu": "H",
        "count": 1
      },
      {
        "AlphaMenu": "HE",
        "count": 1
      },
      {
        "AlphaMenu": "R",
        "count": 4
      },
      {
        "AlphaMenu": "RA",
        "count": 2
      },
      {
        "AlphaMenu": "RI",
        "count": 2
      },
      {
        "AlphaMenu": "T",
        "count": 1
      },
      {
        "AlphaMenu": "TR",
        "count": 1
      },
      {
        "AlphaMenu": "ㄉ",
        "count": 1
      }
    ],
    "IsPeerReviewed": [
      {
        "isPeerReviewed": false,
        "count": 34
      }
    ]
  },
  "SearchResult": {
    "Sessiondetails": {
      "sessionid": "-305671506988218209"
    },
    "Statistics": {
      "TotalHits": 34,
      "TotalSearchTime": 220
    },
    "Data": {
      "RecordFormat": null,
      "Records": [
        {
          "titleId": "3081352",
          "titleName": "BMX",
          "edition": null,
          "description": null,
          "isPeerReviewed": false,
          "publisherName": "Abdo Publishing Company",
          "identifiersList": [
            {
              "id": "978-1-62403-439-8",
              "source": "Print ISBN",
              "subtype": 1,
              "type": 1
            },
            {
              "id": "978-1-306-12566-6",
              "source": "Online ISBN",
              "subtype": 2,
              "type": 1
            },
            {
              "id": "978-1-61913-685-4",
              "source": "Online ISBN",
              "subtype": 2,
              "type": 1
            },
            {
              "id": "978-1-62968-282-2",
              "source": "Online ISBN",
              "subtype": 2,
              "type": 1
            },
            {
              "id": "795839",
              "source": "EP Book ID",
              "subtype": 0,
              "type": 7
            }
          ],
          "subjectsList": [
            {
              "type": "BISAC",
              "name": "JUVENILE NONFICTION / Sports & Recreation / General"
            }
          ],
          "isTitleCustom": false,
          "pubType": "Book",
          "contributorsList": [
            {
              "type": "Author",
              "contributor": "Hamilton, John"
            }
          ],
          "customerResourcesList": [
            {
              "titleId": 3081352,
              "packageId": 1861142,
              "packageName": "MyiLibrary",
              "packageType": "Variable",
              "isPackageCustom": false,
              "vendorId": 58388,
              "vendorName": "Ingram Content Group, Inc.",
              "locationId": 9270070,
              "isSelected": true,
              "isTokenNeeded": false,
              "managedCoverageList": [
                {
                  "beginCoverage": "2012-01-01",
                  "endCoverage": "2012-12-31"
                }
              ],
              "customCoverageList": null,
              "coverageStatement": null,
              "managedEmbargoPeriod": {
                "embargoUnit": null,
                "embargoValue": null
              },
              "customEmbargoPeriod": {
                "embargoUnit": null,
                "embargoValue": 0
              },
              "url": "http://lib.myilibrary.com?id=543817",
              "packageToken": {
                "factName": null,
                "value": null
              },
              "vendorToken": {
                "factName": null,
                "value": null
              },
              "note": [],
              "userDefinedFields": [],
              "visibilityData": {
                "isHidden": false
              },
              "linkOutTargetUrl": "https://sandbox.ebsco.io/pf/externallink/b8d3e3e4-e7ea-4e81-86c2-a7b6f7234723/4aff167a-9d0f-4f6f-aa5d-ec5faea49d95",
              "targetUrl": null
            }
          ],
          "duration": "0",
          "frequency": null,
          "alternateTitleList": []
        },
        {
          "titleId": "568969",
          "titleName": "BMX Biking (BMX Biking)",
          "edition": null,
          "description": null,
          "isPeerReviewed": false,
          "publisherName": "Abdo Publishing Company",
          "identifiersList": [
            {
              "id": "978-1-57765-926-6",
              "source": "Print ISBN",
              "subtype": 1,
              "type": 1
            },
            {
              "id": "978-1-61613-967-4",
              "source": "Online ISBN",
              "subtype": 2,
              "type": 1
            },
            {
              "id": "403357",
              "source": "EP Book ID",
              "subtype": 0,
              "type": 7
            },
            {
              "id": "8ASW",
              "source": "MID",
              "subtype": 0,
              "type": 8
            }
          ],
          "subjectsList": [
            {
              "type": "BISAC",
              "name": "JUVENILE NONFICTION / Sports & Recreation / Cycling"
            }
          ],
          "isTitleCustom": false,
          "pubType": "Book",
          "contributorsList": [
            {
              "type": "Author",
              "contributor": "Vieregger, K. E."
            }
          ],
          "customerResourcesList": [
            {
              "titleId": 568969,
              "packageId": 1861142,
              "packageName": "MyiLibrary",
              "packageType": "Variable",
              "isPackageCustom": false,
              "vendorId": 58388,
              "vendorName": "Ingram Content Group, Inc.",
              "locationId": 10970076,
              "isSelected": true,
              "isTokenNeeded": false,
              "managedCoverageList": [
                {
                  "beginCoverage": "2011-01-01",
                  "endCoverage": "2011-12-31"
                }
              ],
              "customCoverageList": null,
              "coverageStatement": null,
              "managedEmbargoPeriod": {
                "embargoUnit": null,
                "embargoValue": null
              },
              "customEmbargoPeriod": {
                "embargoUnit": null,
                "embargoValue": 0
              },
              "url": "http://lib.myilibrary.com?id=554837",
              "packageToken": {
                "factName": null,
                "value": null
              },
              "vendorToken": {
                "factName": null,
                "value": null
              },
              "note": [],
              "userDefinedFields": [],
              "visibilityData": {
                "isHidden": false
              },
              "linkOutTargetUrl": "https://sandbox.ebsco.io/pf/externallink/b8d3e3e4-e7ea-4e81-86c2-a7b6f7234723/05c8a3a6-dee2-427f-9937-f1148b554497",
              "targetUrl": null
            }
          ],
          "duration": "0",
          "frequency": null,
          "alternateTitleList": []
        }
      ]
    }
  }
}


For more information on the GET publications by title attributes resource, please refer to our interactive or service reference documentation.