Endpoints

Credits

Your credit balance — check it before starting large searches.

curl "https://prospectcheap.com/api/credits?history=1" \
  -H "Authorization: Bearer pc_live_your_key"
{
  "balance": 4820,
  "history": [
    { "amount": -28, "reason": "yp_search_reserve", "description": "Yelp search: plumbers — Austin, TX", "created_at": "2026-10-23T09:12:00Z" }
  ]
}

Without history=1 only balance is returned. A search returns 402 with code: "insufficient_credits" when the balance is too low.

Delete a list

curl -X DELETE https://prospectcheap.com/api/yelp/lists/LIST_ID \
  -H "Authorization: Bearer pc_live_your_key"

Deletes the list and its rows. A running search is stopped and its reserved credits returned.