Last 7 days, UTC

Average Latency
350ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Endpoints

HTTP 200 : Scope Model POST/AddProbe
						{
  Status: 200,
  Comment: "OK",
  ScopeId: 678678,
  NewScope: true
}						
Create Ping

Test console
Description
Parameter
string

JSON array of feeds
Example: ["feed1.com/rss', 'feed2.com/rss']

feeds

Optional

string

comma separated list of keywords
Example: keyword1,keyword2

keywords

Optional

string

Possible values: 'any', 'all'
Example: any

keywordMode

Optional

number

Only include stories which have equal or higher amount of FB likes than this value.
Example: 123

fbLikes

Optional

number

Only include stories which have equal or higher amount of FB shares than this value.
Example: 123

fbShares

Optional

number

Only include stories which have equal or higher amount of FB comments than this value.
Example: 50

fbComments

Optional

number

Only include stories which have been tweeted equal or higher amount of times.
Example: 500

tweets

Optional

string

ID obtained from Login method
Example: E875763F-C5E8-4F52-A4F6-62584E66A28C

sessionId

Required

string

Name of the ping
Example: My custom ping

probeName

Required

string

The description of the ping
Example: This is a test description of my custom ping.

probeDescription

Required

boolean

Use 'true' or 'false'. If 'true' then the ping will be acting like one created by AllPings method. Otherwise it will pick up stories from CloudSearch query.

allPings

Required

HTTP 200 : IsUrlPingedToSignal Model GET/{sessionKey}/IsUrlPingedToSignal
						{
  "Comment": null,
  "Status": 200,
  "IsAlreadyPinged": false
}						
Is URL pinged to signal

Checks whether a given URL was already pinged to a given signal. Requires a valid session key for authentication.


Test console
Description
Parameter
string

The sessionKey obtained from Logon method. Identifies the caller.
Example: 14AD6059-4B4F-458E-B3D1-12F505288FA4

sessionKey

Required

string

The URL to be examined, whether it was pinged or not.
Example: http://example.com

url

Required

string

ID of the signal which is checked against the given URL. Can be obtained on the page of that signal within http://ping.it web application.
Example: 12345

sid

Required

HTTP 200 : Login Model GET/{apikey}/login
Login model which returns status code, message and the sessionKey, used for further requests.
						{
  "Comment": "Wrong username or password",
  "Status": 501,
  "SessionKey": null
}						
Login

Logs user in for the specified application key and returns session key, which is used to authorize further requests. The session key is valid for 10 minutes and is automatically refreshed on each request which uses this session key.


Test console
Description
Parameter
string

API key received from Ping.it.
Example: 42d28989-869f-4fde-9ac7-6b8d441708af

apikey

Required

string

Your Ping.it login (email).
Example: sampleaccount@example.com

u

Required

string

Your Ping.it password.
Example: password

p

Required

HTTP 200 : Base Model GET/{sessionKey}/logout
Common ping API model. Returned when logging out (destroying sessionKey) and pinging.
						{
  "Comment": "Success",
  "Status": 200
}						
Logout

Destroys a session key, making it not possible to use it for request authentication.


Test console
Description
Parameter
string

The sessionKey obtained from Logon method.
Example: 14AD6059-4B4F-458E-B3D1-12F505288FA4

sessionKey

Required

HTTP 200 : Base Model POST/PingByIds/
Common ping API model. Returned when logging out (destroying sessionKey) and pinging.
						{
  "Comment": "Success",
  "Status": 200
}						
Ping to signal

Sends a ping to a specified signal. The ping is defined by a URL. Requires a valid session key to authenticate the request.


Test console
Description
Parameter
string

The session identifier obtained from Login method.
Example: 14AD6059-4B4F-458E-B3D1-12F505288FA4

sessionId

Required

string

The URL to be pinged.
Example: http://example.com

pingedUrl

Required

string

The title of the ping.
Example: My ping title

pingComment

Required

string

This is a longer description of the ping. It usually contains heads-up of the pinged content.
Example: Ping description. It usu

messageText

Optional

string

An image which should be added to the ping body.
Example: http://example.com/myimage.jpg

imageUrl

Optional

number

Identifier of the signal. Can be obtained on the page of that signal within http://ping.it web application.
Example: 12345

groupIds

Required

number

If set to 1 the ping will contain an auto-detected image in the ping body instead of the image specified by pingedUrl parameter.
Example: 1

useDefaultImg

Optional

Consume this API completely for free!


By joining the mashape API marketplace you can start using Ping.it API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.