Publication.Search

Searches for publications matching a specified word or phrase.

HTTP Operation

HTTP GET

URL

https://www.mblast.com/api/rest/v.01/publication.search.aspx

Parameters

See the documentation for creating REST queries.

ParameterData typeDescription
apiapi (required)mBLAST API assigned to developer.
searchstring (required)The word or phrase to search for.

Sample Request URL: https://www.mblast.com/api/rest/v.01/publication.search.aspx?un=demo&pw=demo&recordID=12345

Response Elements

Response are returned in an XML document.

FieldDescription
responseContains the query response.
publicationContains the individual publication information.
recordIDThe recordID assigned to the publication.
nameThe name of the publication.
publisherThe company ID of the company which produces the publication.
descriptionThe description of the publication.
linkThe URL of the publication's web site.
address1The first address line for the publication's address.
address2The second address line for the publication's address.
cityThe city for the publication's address.
stateprovinceThe state or province for the publication's address.
postalcodeThe postal code for the publication's address.
countryThe country for the person's address
target audienceA description of the publication's target audience, which is the group of readers or viewers who are the subscribers for the publication.
circulationFor print publications, circulation is the total paid and unpaid distribution of the publication.
typeThe type of publication.
frequencyThe frequency with which the publication is issued.
topicfocusThe target geographical coverage of the publication in terms of topical coverage.
editcalcycleThe governing period of the editorial cycle. For instance, an annual calendar cycle applies if you issue your editorial calendar once a year.
editcalmanagerThe person ID for the manager of the editorial calendar.
editcallinkThe URL of the editorial calendar web page.
editstaffcontactThe contact for the editorial staff.
editstafflinkThe URL of the editorial staff web page.
issnThe International Standard Serial Number for the publication. The ISSN is a code used on catalogues, databases, or commercial transactions each time serial publications are involved. More info at http://www.issn.org.
keywordsKeywords associated with the publication, separated by commas.

Example response

The following is an example of the response returned by the Publication.Search method.

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <publication>
    <recordID>12345</recordID>
    <name>802.11a News</name>
    <publisher>12345</publisher>
    <description>
      Magazine dedicated to products and services 
      utilizing the 802.11a broadband wireless standard. 
    </description>
    <link>http://www.80211anews.com</link>
    <target audience>
      End users, resellers, distributors, service 
      providers, etc. 
    </target audience>
    <circulation>20000</circulation>
    <type>4</type>
    <frequency>1</frequency>
    <topicfocus>6</topicfocus>
    <keywords>broadband, wireless, 802.11a</keywords>
  </publication>
</response>

Errors

Publication.Search returns the standard errors. There are no errors specific to this method.