Description:
Lists all your active bids.
URL:
https://api.bedrock.com/query/1.0/bid/list
HTTP Request Methods:
GET, POST
API Rate Limit:
None. However, BEDROCK reserves the right to limit API requests. If you are concerned about your volume please contact support.
Sample API Call:
https://api.bedrock.com/query/1.0/bid/list?apikey=3eb2b085c8363457dd56f42f54ee9gh6&format=json
|
Request Parameters:
| Name | Description | Required | Example Values
| | apikey | A 32-character secret key given to you upon registration. | Yes | 3eb2b085c8363457dd56f42f54ee9gh6 | | format | Choose a response format. Supported formats:
| No | xml
| | callback | Used w/ json format. Response will be JSONP w/ the passed value as a callback.
| No | foo |
XML Response:
A successful response will have <success> and <bid> elements containing your active bids and their fields.
<response>
<success>true</success>
<bids>
<bid>
<id>2342432</id>
<url>http://mysite.com/?q=$keyword&source=bedrock</url>
<amount>0.2</amount>
<createdat>1248993374</createdat>
<keywords>
<keyword>gardening</keyword>
<keyword>john coltrane</keyword>
</keywords>
<countryrule>include</countryrule>
<countries>
<country>US</country>
</countries>
</bid>
</bids>
</response>
|
An unsuccessful response will contain one or more <error> elements indicating the problematic request parameter field.
<errors>
<error>
<field>apikey</field>
<message>cannot be empty</message>
</error>
</errors>
|
Usage Notes:
|
|
