FAQ

What is a credit?

One credit equals one API call. Credits are deducted each time you make a successful request to any endpoint. Some endpoints may cost more than 1 credit — check the individual API pages.

Credits reset to your plan’s monthly allowance at the start of each billing period.

How do I authenticate?

Create an API key on the API Keys page and include it in every request:

X-API-Key: dc_your_key_here

Or as a Bearer token:

Authorization: Bearer dc_your_key_here

What happens when I run out of credits?

Requests return 402 Payment Required with {"error": "insufficient credits"}. You can upgrade your plan on the Billing page, or wait until your credits reset next month.

Am I charged for failed requests?

No. If an API returns a server error (5xx), the credit is automatically refunded. You are only charged for requests that were successfully processed (2xx and 4xx responses).

Can I use multiple API keys?

Yes. You can create up to 10 API keys per account, useful for separating environments (development, staging, production) or tracking usage per project.

How do I paginate results?

Endpoints use two different pagination styles:

• Page-based (Google, Flight Award): pass an incrementing page parameter.
• Cursor-based (Twitter, Idealista, OfferUp): use the nextPageToken returned in each response.

Each page costs 1 credit.

Can I upgrade or downgrade my plan?

Yes, at any time from the Billing page. Changes take effect immediately.

Are there rate limits?

Yes. Requests are rate-limited per API key to prevent abuse. The limits are generous for normal usage patterns. Contact support if you need higher throughput.

What data sources do the APIs use?

The APIs scrape data directly from the source websites (Google, X/Twitter, Idealista, OfferUp, flight award databases) in real time. Results reflect what is publicly visible on those platforms at the time of the request.

Can I request a new API?

Yes. Send your request to support with a description of the data source and your use case.

Can I delete my account?

Yes. Go to Settings and scroll to the Delete Account section. This is irreversible — all your API keys and usage history will be permanently removed.