Citygate Company Guide API v1

This API is part of the Company Guide services provided by Citygate. In order to use these functions, you have to register a user at Citygate.

Paying Companies Search Right Now Service Locations

Paying Companies

  • URL: http://guide.api.citygate.se/newspaper/{newspaperId}/payingcompanies/?apikey={guid}
  • Parameters:
    • newspaperId: (int) (required) Filter on paying companies for the given newspaper.
    • apiKey: (required) The unique guid given to you.
  • Method: GET
  • Cache: 3600 seconds
  • Response:
    [{
    	CompanyName: "Armyshopen i Umeå",
    	ShortDescription: "Jakt - Airsoft - Fiske - Camoflage",
    	LongDescription: "Hos oss hittar du svenskt och utländskt militärt överskott. Vi har ca 30 olika camoflagevarianter, varor för polis och väktare, airsoftare, jakt- och fiske m m. Vi utvecklas ständigt och vårt sortiment är under ständig förändring. Du hittar även väskor, mössor, kepsar, sockar och mycket mycket mera. Välkommen!",
    	LogoUrl: "http://logo.citygate.se/VK/logo/137830_logo.gif",
    	CompanyId: "200655582_15",
        CgCustomerId: "470133"
    }]

Returns a list of matching paying companies. If a property does not contain a value, a empty string is returned.

Right Now Service

  • URL: http://guide.api.citygate.se/newspaper/{newspaperId}/services/rightnow/?apikey={guid}&newspaperIds={int, ...}&countyIds={int, ...}&cityIds={int, ...}&limit={int}
  • Parameters:
    • newspaperId: (int) (required)Filter on ads for the given newspaper.
    • apiKey: (required) The unique guid given to you.
    • newspaperIds: (required) Comma sepatated list (optional) If supplied, the functions returns all locations for the given newspaper(s) with ads. Use to impersonate another newspaper in the same group. If not supplied, defaults to your registered newspaper.
    • countyIds: (optional) Comma sepatated list, see link for County ID's.
    • cityIds: (optional) Comma sepatated list, see link for City ID's.
    • limit: (optional) Limit the search for a number of results.
  • Method: GET
  • Cache: 21600 seconds
  • Response:
    [{
        "LogoUrl": "http://logo.citygate.se/VK/logo/135866_logo.gif",
        "CompanyId": "200352964_15",
        "Headline": "Butik i Umeå",
        "Ingress": "",
        "Body": "Brett sortiment, Villa   Skog o Fritid.",
        "CompanyName": "Boströms Traktor & Maskiner Umeå"
    }]

Returns a list of matching service companies.

Locations

  • URL: http://guide.api.citygate.se/locations/?apikey={guid}
  • Parameters:
    • apiKey: (required) The unique guid given to you.
    Method: GET
  • Cache: 21600 seconds
  • Response:
    [{
        "CountyId": 1,
        "Name": "Stockholm (län)",
        "Cities": 
        [{
            "ParentCountyId": 1,
            "CityId": 114,
            "Name": "Upplands Väsby",
            "Districts": [ ]
        }]
    }]

Returns a list of locations.