FAQ
Short answers to common questions about the Platinux API.
Getting started
How do I get an API key?
Sign in at platinux.net/dashboard/score and create a key. It is shown only once, so copy it straight away. See Authentication.
What do I need before I can score?
A template. Call GET api-templates and use the template_id with "is_live": true. Every scoring call needs it.
What is a template?
The set of buying signals that count towards a score. You create and edit templates in the Platinux app. The API only lists them.
Scores
What does the score mean?
A number from 0 to 100. Higher means the company is showing stronger buying signals for what your template looks for.
Is the score about the person or the company?
The company. When you send an email or a person's LinkedIn profile, we find their current company and score that.
How long does a score take?
Usually 1 to 3 minutes. Scoring runs in the background: you get a job_id (or a batch_id for a list) and check back after check_after_seconds.
Why is my result partial?
Some data didn't arrive in time. The score uses what did arrive. See Status values.
Credits
What does a score cost?
10 credits for a domain, LinkedIn URL, or company or work email. 20 for a generic email (Gmail, Outlook, etc.). Full table in Credits.
Am I charged when nothing is scored?
No. Invalid inputs, temporary emails, companies we can't find and rejected websites all cost 0.
Is a score reused if I send the same company again?
No. Every run is scored and charged again. Within one list, inputs that lead to the same company are charged once.
What happens when I run out of credits?
Scoring calls return 402 insufficient_credits. Top up in the app and try again.
Limits and errors
How many companies can I score at once?
Up to 1,000 inputs per bulk call, with one scoring list running at a time per account. See Limits.
Can I score with a template that isn't live?
Not yet. Scoring uses your live template only.
Which errors are safe to retry?
500, 502 and network errors. See Errors for every code.