Use GET
method with URL https://indian-names-api.herokuapp.com/name
?beg=a
Fetches the names beginning with given letters
- accepts character string for name to start with eg
?beg=abdr
will fetch names starting with a,b,d or r- by default, fetches name beginning with any alphabet
Example response:
[ { "fullname_indian_title": "sri. aditya singh", "fullname_english_title": "mr. aditya singh", "fullname": "aditya singh", "firstname_indian_title": "sri. aditya", "firstname_english_title": "mr. aditya", "firstname": "aditya", "lastname_indian_title": "sri. singh", "lastname_english_title": "mr. singh", "lastname": "singh" } ]
?c=2
Count of random names to fetch,
- accepts any positive integer
- default=1, max=117 (max depends upon the search query and 117 is the total of unique names).
Example response:
[ { "fullname_indian_title": "smt. chavi shukla", "fullname_english_title": "mrs. chavi shukla", "fullname": "chavi shukla", "firstname_indian_title": "smt. chavi", "firstname_english_title": "mrs. chavi", "firstname": "chavi", "lastname_indian_title": "smt. shukla", "lastname_english_title": "mrs. shukla", "lastname": "shukla" }, { "fullname_indian_title": "sri. rakesh bansal", "fullname_english_title": "mr. rakesh bansal", "fullname": "rakesh bansal", "firstname_indian_title": "sri. rakesh", "firstname_english_title": "mr. rakesh", "firstname": "rakesh", "lastname_indian_title": "sri. bansal", "lastname_english_title": "mr. bansal", "lastname": "bansal" } ]
?gen=f
Fetches name of any specific gender
- accepts
m
orf
, in other cases it will work as default- default is gender-neutral
Example response:
[ { "fullname_indian_title": "smt. yashodha yadav", "fullname_english_title": "mrs. yashodha yadav", "fullname": "yashodha yadav", "firstname_indian_title": "smt. yashodha", "firstname_english_title": "mrs. yashodha", "firstname": "yashodha", "lastname_indian_title": "smt. yadav", "lastname_english_title": "mrs. yadav", "lastname": "yadav" } ]
?beg=x&gen=f&strict
If no more name matches the query string than by default it will fetch any other related name(not exact match) but to prevent this, use&strict
to avoid false responses
Example response:
withstrict
[ ]
without
strict
[ { "fullname_indian_title": "smt. geetanjali chakraborty", "fullname_english_title": "mrs. geetanjali chakraborty", "fullname": "geetanjali chakraborty", "firstname_indian_title": "smt. geetanjali", "firstname_english_title": "mrs. geetanjali", "firstname": "geetanjali", "lastname_indian_title": "smt. chakraborty", "lastname_english_title": "mrs. chakraborty", "lastname": "chakraborty" } ]
notice that
gen=f
still stands